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FOREWORD 



DECsystem-10 Operating System Commands is a complete reference document describing the commands 



available in the DECsystem-10 operating system. The information presented in this manual reflects the 
5.05 release of the monitor and other related programs. Commands to both the monitor command lan- 
guage interpreter and the programs in the Batch system are grouped in alphabetical order for easy ref- 
erence to the command repertoire. 

DECsystem-10 Operating System Commands does not include reference material on assembly language 
programming. This information can be found in DECsystem-10 Monitor Calls (DEC-10-MRRC-D), 
which is intended for the experienced assembly language programmer. Included in DECsystem-10 



Monitor Calls are discussions of the monitor programmed operators and the various I/O devices con- 
nected to the system. The two manuals, DECsystem-10 Operating System Commands and DECsystem-10 
Monitor Calls, supersede the Timesharing Monitors Programmer's Reference Manual (DEC-T9-MTZD-D) 
and all of its updates. 

A third manual, Introduction to DECsystem-10 Software (DEC-10-MZDA-D), is a general overview 
of the DECsystem-10. It is written for the person, not necessarily a programmer, who knows computers 
and computing concepts and who desires to know the relationship between the various components of 
the DECsystem-10. This manual is not intended to be a programmer's reference manual, and therefore, 
it is recommended that it be read at least once before reading the above-mentioned reference 
documents. , 

SYNOPSIS OF DECsystem-10 OPERATING SYSTEM COMMANDS 

Chapter 1 presents all of the commands available to the user and introduces the various components of 
the operating system that interface with the user. Chapter 2 is a detailed description of the commands 
processed by the monitor command language interpreter. Presented in Chapter 3 are the commands to 
the Batch system and a discussion of the programs in this system. The DECsystem-10 system error mes- 
sages and error codes are listed in Chapter 4 along with descriptive information on how to correct the 
errors. The appendices contain supplementary reference material and tables. 

5.05 Monitor xii June 1972 
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CONVENTIONS USED IN DECsystem-10 OPERATING SYSTEM COMMANDS 
The following conventions have been used throughout this manual: 

dev: Any logical or physical device name. The colon must be 

included when a device is used as part of a file specification. 

I' st A single file specification or a string of file specifications. 

A file specification consists of a filename (with or without 
a filename extension), a device name if the file is not on 
disk, a project-programmer number, if the fi le is not in the 
user's disk area, and a protection code. 

ar 9 A pair of file specifications or a string of pairs of file speci- 

fications. 

i°b n A job number assigned by the. monitor. 

file.ext Any legal filename and filename extension. 

core Decimal number of IK blocks of core. 

adr An octal address. 

C(adr) The contents of an octal address. 

[proj,progj Project-programmer numbers; the square brackets must be 

included in the command string. 

fs Any legal file structure name or abbreviation. 

($) «• The symbol used to indicate an altmode. 

tx A control character obtained by depressing the CTRL key 

and then the character key x. 

A back arrow used in command strings to separate the input and 
output file specifications. 

The system program response to a command string. 

The monitor response to a command string. 

j The symbol used to indicate that the user should depress the 

RETURN key. This key must be used to terminate every com- 
mand to the Monitor Command Language Interpreter. 

Underscoring used to indicate computer typeout. 

n A decimal number. 

= An equal sign used in command strings to separate the 

input and output file specifications. 




XIII 
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CHAPTER 1 
INTRODUCTION 



The DECsystem-10 Operating System is the interface between the user and the actual machine. The 
operating system, or monitor, has many functions, some of which are: 

1. scheduling multiple and simultaneous use of the system, 

2. protecting users of the system from one another, 

3. allowing access to system resources including peripheral devices, 

4. providing a comprehensive disk file system, 

5. directing data flow between peripheral devices and the user's program, 

6. controlling non-interactive jobs, and 

7. overlapping input-output operations with computations for high system efficiency. 

The user communicates with the operating system by means of the monitor command language. With 
the command language he may access all available resources of the computing system and obtain all 
the services provided by the operating system. 

1.1 JOBS 

The DECsystem-10 computing system is a multiprogramming system; that is, control is transferred rap- 
idly among a number of jobs in such a way that qll jobs appear to be running simultaneously. The 
term job refers to the entire sequence of steps, from beginning to end, that the user initiates from his 
interactive terminal or card deck or that the operator initiates from his operator's console. When a 
user initiates a job from his interactive terminal, the beginning of the job is designated by the LOGIN 
command and the end by the KJOB command. If a user initiates a fob with a card deck, the beginning 
of the job is the $JOB card and the end is the end-of-file card. Operator jobs usually begin when the 
system is initialized and end when the system goes down. 

Jobs, which may be timesharing, batch, or real-time in nature, may be initiated at the central com- 
puter site or at remote locations connected by the telephone system. Once a user initiates a job, it 
is possible for him to initiate another job without killing the first one. For example, a user can initiate 
a timesharing job and by using the SUBMIT monitor command submit a second job for batch processing 



1-1 




COMMANDS 



-444- 



(refer to Chapter 2). He may then wait for the results from this batch job, or have the results auto- 
matically output while he continues his timesharing job. 

In configuring and loading the DECsystem-10, the system administrator sets the maximum number of 
jobs that his system can simultaneously handle. This number may be up to 127 jobs if the system has 
enough memory, disk storage, processor capacity, and terminals to handle this load. 

1 .2 MONITOR MODE AND USER MODE 

From the timesharing user's point of view, his terminal is in either monitor mode or user mode. In 
monitor mode, each Ifne the user types in is sent to the monitor command language interpreter. The 
execution of certain commands (as noted in the following examples) places the terminal in user mode. 
When the terminal is in user mode, it becomes simply an I/O device for that user,, In addition, user 
programs use the terminal for two purposes. The user program will either accept user command strings 
from the terminal (user mode) or use the terminal as a direct I/O device (data mode). 



Example (terminal dialogue) : 
monitor mode 
user mode 
data mode 

monitor mode 



• R PIP*? 

♦DSKJPkOGl .KAOTTY: J 

THIS IS FILE 1 tZ 

*tC 



monitor command 

user command string 

user program using terminal 
as input device 

monitor command 



user mode 
data mode 



*,TTY:-DSK:PR0G1-J 



assembly listing 



user command string 

user program using terminal 
as an output device 



The special character tC (produced by typing C with the CONTROL key depressed) is used by a time- 
sharing user to stop a user program and return the terminal to monitor mode. If the user program is 
waiting for input from the terminal, the user needs to type only one tC to return the terminal to 
monitor mode; otherwise, he must type two tC's. Because of this procedure, the user knows that his 
program is not waiting for input if there is no response from the monitor after one tC. Certain com- 
mands cause the user program to start running or to continue (as noted in the following chapter) but 
leave the terminal in monitor mode. 
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When the system is started, each terminal is in monitor mode ready for users to log in. However, if 
the system becomes fully loaded (i.e., the maximum number of jobs that the system is set to handle 
has been initiated), then any unused terminals from which access is requested will receive the message 
JOB CAPACITY EXCEEDED. 

The card-oriented Batch user can think of his cards as being in stack mode, monitor mode, or user 
mode. When the card is in stack mode, it contains a control command beginning with a $ (refer to 
Chapter 3) and is sent to the Stacker, CDRSTK. CDRSTK interprets these commands and performs var- 
ious actions to create a control file for the Batch Controller. When the card is in monitor mode, it 
contains a monitor command preceded by a period and is copied by CDRSTK into the control file. 
When the card is in user mode, it contains a user-level program command preceded by an asterisk or 
an equal sign and is also copied by CDRSTK into the control file. As each line in the control file is 
executed, the Batch Controller passes the monitor-level line to the monitor command language inter- 
preter and the user- level line to the user program. 

Example (sample card deck): 



USER MODE 

MONITOR MODE 

MONITOR MODE 

STACK MODE 

DATA MODE 

STACK MODE 




END OF CARD DECK 

USER COMMAND STRING 
MONITOR COMMAND 
MONITOR COMMAND 
CDRSTK CONTROL COMMAND 

CDRSTK CONTROL COMMAND 



1.3 COMMAND INTERPRETERS 

1.3.1 Monitor Command Language Interpreter 

When the terminal is in monitor mode, the user communicates with the monitor command language in- 
terpreter. By means of commands to this interpreter, the user may initialize jobs, allocate facilities, 
prepare source files, manipulate files, prepare, control, and examine object programs, control job 
sequences and multiple jobs, terminate jobs, send messages, and obtain job and system information. 
The commands described in Chapter 2 are processed by this interpreter. 
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Most commands are processed without delay. However, a command may be momentarily delayed if a 
jot is swapped out to the disk and the command requires that the job be resident in core; the command 
is executed when the |ob is swapped into core. The completion of each command is signaled by the 
output of a carriage return, line feed sequence. If the terminal is left in monitor mode, a period fol- 
lows the carriage return, line feed. If the terminal is left in user mode, any response other than a 
carriage return, line feed comes from the user'.s program. For example, most standard system programs 
immediately send an asterisk(*) to the user's terminal to indicate their readiness to accept user com- 
mand strings. 

The type-ahead technique may be employed by the experienced timesharing user at a terminal. This 
means that the user does not have to wait for the completion of one command before he can begin an- 
other. For example, if two operations are desired from the monitor, the request for the second opera- 
tion can be typed before receiving the period after completion of the first. 

The command interpreter makes several checks before processing commands from users. On disk systems, 
if a user who has not logged in types a command that requires him to be logged in, the system responds 
with 

?LOGIN PLEASE 

and the user's command is not executed. The commands discussed in Chapter 2 all require login except 
where explicitly stated otherwise. When a command is recognized that requires the job to have core 
and the job has no core allocated, the command interpreter responds with 

?NO CORE ASSIGNED 

and the user's command is not executed. 

1 .3.1 . 1 Special Characters - There are several special characters recognized by the monitor com- 
mand language interpreter that cause specific functions to be performed. As noted previously, control- 
C (tC) interrupts the program that is currently running and returns the terminal to monitor mode. This 
character causes the input line back to the last break character (e.g., carriage return, line feed) to 
be deleted (equivalent to the action of a tU). Two control-C's are necessary if the user program is 
not requesting input from the terminal (i.e., the program is in the middle of execution). 

The RUBOUT key on the terminal generates a character that causes the last character typed to be de- 
leted. This permits correction of typing errors. Depressing the RUBOUT key n times causes the last n 
characters typed to be deleted. The deleted characters are echoed on the terminal enclosed in back- 
slashes (\ ). Characters beyond the last break character or characters already processed by the user 
program are not deleted. 
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Control-U (*U) causes the deletion of the current line, back to the last break character. The system 
responds with a carriage return, line feed so that the line may be typed again. Once a break charac- 
ter has been typed, line-editing features ( tU and RUBOUT) can no longer be used on that line, except 
when running TECO. 

Control-O (tO) suppresses output to the terminal. The system responds with a carriage return, line 
feed sequence. A subsequent control-O re-enables output to the terminal. At remote stations, the 
effect of the tO may be somewhat delayed. 

1.3.2 Batch Command Interpreter 

The monitor command language interpreter is used for all monitor commands submitted via the Batch 
system. In addition, the Batch user issues commands that are only used by the Batch programs, Stacker 
(CDRSTK) and Batch Controller (BATCON). Control commands, discussed in Chapter 3, are processed 
by the Stacker and, by means of these commands, the user can create a control file, a log file, and 
data files; can enter jobs into the Batch input queue; and can insert monitor commands into the control 
file. An additional interpretation is done by the Batch Controller. When the job is executed, the 
Batch Controller processes the control file to pass monitor commands to the monitor command language 
interpreter and user-level commands to the appropriate programs. 

1.4 COMMAND FORMATS 

Each command is a line of ASCII characters in upper and/or lower case. Spaces and TABs preceding 
the command name are ignored. Comments may be typed on the same line as the command by preceding 
the comment with a semicolon. The monitor and batch command language interpreters do not interpret 
or execute a line of comments. Every command to the monitor command interpreter should be termi- 
nated by pressing the RETURN key on the console. In examples in this manual, the symbol J is used 
to indicate that the user should depress the RETURN key. If the command is in error, the command up 
to the error is typed out by the monitor preceded and followed by a ?, and the terminal remains in 
monitor mode. 

1.4.1 Command Names 

Commands to the monitor command interpreter are alphabetic strings of one to six characters; charac- 
ters after the sixth are ignored. Only enough characters to uniquely identify the command need be 
typed. It is recommended that a Batch job use the full command name since the abbreviations may 
change with the addition of new commands. 
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Instal lotions choosing to implement additional commands should take care to preserve the uniqueness 
of the first three letters of existing commands. 

Control commands to the Stacker in the multiprogramming batch system must have a dollar sign ($) in 
the first column of the card or the line and an alphabetic character in the second column. Only the 
first part of the command name need be specified; as long as the specified command name is unique, it 
is accepted. The first three characters of the command name are generally sufficient to ensure unique- 
ness. 

1 .4.2 Command Arguments 

Arguments follow the command name and are separated from it by a space or TAB. If the monitor com- 
mand interpreter recognizes a command name, but a necessary argument is missing, the monitor responds 
with 

?TOO FEW ARGUMENTS 

Extra arguments are ignored . 

1 .4.2.1 Project- Programmer Numbers and Passwords - Access to the DECsystem-10 is limited to 
authorized users. The system administrator provides each authorized user with a project number, a 
programmer number, and a password. The project numbers range from 1 to 377777 octal (numbers 1 
to 10 are reserved for DEC) and the programmer numbers range from 1 to 777777 octal (numbers 1 to 7 
are reserved for DEC and numbers 400000 to 777777 are reserved for special purposes) . These numbers 
identify the user and his file storage area on a file structure. In a command string, the project and 
programmer numbers are separated with a comma and must be enclosed in square brackets, e.g., [10,7] . 

The passwor d is from one to six SIXBIT characters and is only used when logging on the computing sys- 
tem. To maintain password security, the monitor does not echo the password. On terminals with local 
copy (refer to DECsystem-10 Monitor Ca lls), a mask is typed to make the password unreadable. 

1 .4.2.2 Device Names - Associated with each system device controlled by the computing system is 
a physical device name. This name consists of three letters, zero to three numerals specifying the 
unit number, and a colon. Table 1-1 lists the generic physical device names associated with the 
various system devices. 



When the programmer number is from 1 to 7, all project numbers are reserved for DEC. 
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Table 1-1 
System Devices 



Device 


Generic Physical Device Name 


All Disks 


ALL: 


Card Punch 


CDP: 


Card Reader 


CDR: 


Console TTY 


CTY: 


DECtape 


DTx:t 


Disk 


DSK: 


Packs 


DPx:t 


Fixed- Head 


FHx:t 


Display 


DIS: 


Experimental System Library 


NEW: 


Help Library 


HLP: 


Line Printer 


LPT: 


Magnetic Tape 


MTA: 


Operator Terminal 


OPR: 


Paper-tape Punch 


. PTP: 


Paper-tape Reader 


PTR: 


Plotter 


PLT: 


Pseudo-TTY 


PTY: 


System Library 


SYS: 


Terminal 


TTY: 


tX represents A,B,. . ., indicating the first controller, second con- 


troller, etc. 





The user may also assign a logical device name to a physical device. The logical name is from one to 
I six alphanumeric characters of the user's choice, followed by a colon, and is used synonymously with 
a physical device name in all references to the device. Logical device names allow the user, when 
writing his program, to use arbitrarily selected device names, which he assigns to the most convenient 
physical devices at run time. However, care should be exercised when assigning logical device names 
because these names have priority over physical device names. For example, if a DECtape is assigned 
the logical name DSK, then all of the user's programs attempting to use the disk via the device name 
DSK will use the DECtape instead. 

Except for disk devices, only one logical device name can be associated at any one time with a physi- 
cal device. The same logical name can be used for a second physical device by disassociating it from 
the first device and associating it with the second device via the ASSIGN command. Logical device 
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names are disassociated from all devices with the DEASSIGN command (refer to Chapter 2). Subse- 
quent ASSIGN commands (refer to Chapter 2) to all devices except disk devices replace the old logical 
name with the new one. 

The following is an example of the use of physical and logical device names. Underscoring is used to 
indicate computer typeout. 



^ASSIGN OTA: ABC:^) 
DEVICE DTA6 ASSIGNED 

..ASSIGN FTP: ABC;,,) 

% LOGICAL NAME WAS IN USE, 
PTP ASSIGNED 



_.R PIP^ 
*ABC :-DTA6:FILEA J 

_*tC 

^.ASSIGN DTA : DEF:^ 

.ASSIGNED TO JOB N1*N2 » • • • 

^ASSIGN DTA6: DEF i) 
DEVICE DTA6 ASSIGNED 

REASSIGN PTP: J 

■jH PIP^ 
*ABC:-DEF:FILEB^) 

7DFVICE ABC DOES NOT EXIST 



User requests a DECtape drive with the logical name 
ABC. 

Monitor has given the user drive DTA6. The user 
mounts a DECtape on drive DTA6. 

User requests the paper-tape punch with the logical 
name ABC. »■ 

Paper-tape punch is reserved, and ABC now refers to 
the PTP. 

User requests the system program PIP (Peripheral Inter- 
change Program). 

User issues a command string to PIP asking that file 
FILEA be transferred from device DTA6 to logical 
device ABC (physical device PTP: which is assigned 
to the user). 

User returns to monitor mode. 

User requests another DECtape drive with logical name 
DEF. 

All drives are in use by the specified jobs. No 
DECtape drive is assigned, and no logical assign- 
ment is made. 

User requests drive DTA6 (which he already has) with 
logical name DEF. The copy of the directory currently 
in core is cleared. 

User mounts a new DECtape on the previously assigned 
drive. The new DECtape directory is read into core 
when next accessed . 

User deassigns PTP, thereby clearing the logical name 
ABC. 

User requests PIP. 

User requests that file FILEB be transferred from device 
DEF to device ABC. 

The logical device name ABC is no longer assigned. 

(continued on next page) 
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^ASSIGN DTA6: XYZ'.J 
DEVICE DTA6 ASSIGNED 



User returns to monitor mode. 

User requests drive DTA6 again with logical name XYZ. 
The logical name DEF is no longer associated with DTA6. 
The old directory is cleared from core. 

User mounts a new DECtape. The new directory is reaaV/ 
into core when next accessed. 



1 .4.2.3 File Structure Names - Disk devices are grouped according to file structures, which are 
logical arrangements of 128-word blocks on one or more disk units of the same type. Examples of 
types of disk units are: an RP02 disk pack or an RM10B drum. Although a file structure can exist on 
exactly one disk unit, it can be distributed over several disk units of the same type and designated 
by a single name. However, two file structures cannot exist on the same unit. Each file structure has 
a SIXBIT name specified by the operator at structure definition time. This name can consist of five or 
less alphanumeric characters and must not duplicate a physical device name, a unit name, or an exist- 
ing file structure name. The recommended names for public file structures are DSKA, DSKB, . . ., 
DSKN in order of decreasing speed. 



1 .4.2.4 File Specifications - All information (programs and data) in the system is stored as named 
files. Each named file has associated with it a file specification which consists of 

1. the physical device name or file structure name, 

2. the filename, 

3. the filename extension, 

4. the ordered list of directory names, and 

5. the access protection code. 

The first four items of the file specification are necessary to uniquely identify a disk file. File 
specifications are ignored when given for devices other than DECtape or disk since these two devices 
are the only directory-oriented devices. In addition, items 4 and 5 do not apply to DECtapes. 

The physical device name used for DECtape or the fi le structure name used for disk may be any legal 
device name discussed in the foregoing sections. A colon should always follow the device name; e.g., 
DTA3:. The filename is from one to six SIXBIT characters; all characters after the sixth are ignored. The 
filename extension is a period following by zero to three characters and is used to indicate the type of 
information in the file. (Refer to Appendix A for a list of standard filename extensions.) It is recom- 
mended that only the standard extensions be used even though other extensions are valid. Most programs 
only recognize filenames and extensions consisting of letters and digits. The ordered list of directory 
names identifies the disk area in which the file is stored. This list can be a user file directory (UFD) 
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represented by the project- prog rammer number of the owner of the files in the directory or can be a 
user file directory followed by one or more sub-file directories (SFDs). (Refer to the DECsystem-10 
Monitor Calls for a description of SFDs.) The directory name must be enclosed in square brackets. 
The access protection of the file is a three-digit code designating which users can read or write the 
file and must be enclosed in angle brackets. The protection code is specified only for output files. 
For a given file, the users are divided into three groups: the owner of the file, the users with the same 
project number as the owner, and the rest of the users. The standard protection code is 057 which 
allows users in the owner's project to read and execute the file and prevents access by all other users. 
(For a complete description of access protection, refer to DECsystem-10 Monitor Calls.) The standard 
protection code can be redefined by the various installations. 

In command strings, the filename, the device name if the file is not on disk, and the directory name if 
the file is not in the user's disk area, are required. The filename extension, the device name if the 
file is on the disk, the directory name if the file is in the user's disk area, and the protection code are 
optional. The following are examples of file specifications: 

TEX T.MAC filename and extension 

DTA3:FILEA device and filename 

DSK:PROG2.CBL [10,16] device, filename, extension, and 

directory name 
DSKA:MAIN.F4[27,235] <057> complete file specification 

Many command strings allow the wildcard construction to be used. This means that the filename, the » 
extension, or the directory name may be replaced totally with an asterisk or partially with a question 
mark to designate certain filenames, extensions, or directories. The asterisk is used as a wild field to 
designate the entire filename, extension, or directory name. For example, 

filename.* All files with this filename and any extension. 

*.ext All files with this extension and any filename. 

*.* All files. 

*.* [project,*] All files in directories with this project number and 

any programmer number. 

The question mark is used as a wild character to designate part of the filename, extension, or direct- 
ory name. A question mark is used for each character that is to be matched; i.e., PR?? matches on 
four characters or less. For example, 

filename .M?? All files with this filename and any extension 

beginning with M. 

TES?-?.ext All files with this extension and any filename up 

to 5 characters beginning with TES. 

??.??? All files with filenames of two characters or less. 

(continued on next page) 
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[25,5??] All files in directories with the project number 25 

and the programmer numbers 500-577. 

The asterisk and the question mark can be specified together in the same construction. 

'??.* All files with filenames of two characters or less. 

In addition, the directory name can be specified with the project number, the programmer number, or 
both numbers missing. The following are examples of the various ways of representing a particular 
directory . 

[15,23] The UFD [15,23]. 

[,30] The UFD that has the user's project number and the 

specified programmer number (30). 

[36,] The UFD that has the specified project number (36) 

and the user's programmer number. 

[,] The user's UFD. 

[-] The user's default directory which may be different 

from his UFD (refer to the DECs ystem-10 Monitor 
Calls and the SETSRC program). 

The number sign can be used to represent a filename or extension that contains characters that cannot 
be typed because they have special meanings in the system. For example, if a file with the name 
*. MAC were typed in a command string, the user would be referencing all files with the extension 
.MAC since the * designates all files with the specified extension MAC. To allow a filename or ex- 
tension to be typed that is composed of special characters, the user employs the number sign followed 
by the octal representation of the SIXBIT filename or extension. For example, #120000000000 repre- 
sents the file named *. If letters or digits are part of the filename or the extension containing the 
special characters, the octal representation of the letters or digits must also appear following the num- 
ber sign. In other words, the number sign must be placed at the beginning of the filename and all 
characters following must be represented in octal . Furthermore, this construction can be used to read 
the contents of a UFD. For example, # 0000 10000073. UFD [1,1] represents the file named 10,73. UFD 
in the directory [1,1]. 

The programs that recognize the number sign are DUMP, DIRECT, PIP, and QUEUE. 

1 .5 COMPIL-CLASS COMMANDS 

Certain monitor commands simplify communication between the user and the system programs of the 
DECsystem-10 by allowing the user to type a short, concise monitor command string that causes a series 
of operations to be performed . These commands are known as COMPIL-class commands and are de- 
scribed in detail in Chapter 2. These commands cause the monitor to run the COMPIL program, which 
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deciphers the command and constructs new command strings for the system program (e.g., TECO, PIP, 
LINED, FORTRAN) that actually processes the command. Each time CREATE, MAKE, EDIT, or TECO 
is executed, the command with its arguments is written as a temporary file in core or on the disk. 
Therefore, the file specification last edited may be recalled for the next edit without specifying the 
arguments again. (This is an exception to the requirement that the filename must always be specified. ) 
For example, if the command 

.CREATE PROGX.MAC 
is executed, then the user may later type the command 

.EDIT 
instead of 

.EDIT PROGX.MAC 
assuming no other EDIT-class command that changed the filename was used in the interim. 

The COMPILE, LOAD, EXECUTE, and DEBUG commands with their arguments are also written in a 
temporary file so that the file specification given last may be recalled without specifying the arguments 
again. 

The temporary files containing these file specifications have filenames of the following form: 
nnnxxx.TMP 

where "nnn is the user's job number in decimal, with leading zeros to make three digits, and xxx speci- 
fies the use of the file. Refer to Appendix C for a list of the temporary files. 

1.5.1 Indirect Commands (@ Construction) 

When there are many program names and switches, they can be put into a file and do not have to be 
typed in for each compilation. This is accomplished by the use of the @ file construction, which 
may be combined with any COMPIL-class command. 

The @ file may appear at any point after the first word in the command. In this construction, the 
word file must be a filename, which may have an extension and a project- prog rammer number. If the 
extension is omitted, a search is made for the command file with a null extension and then for a com- 
mand file with the extension .CMD. The information in the specified command file is then put into 
the command string to replace the characters @ file. 
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For example, if the file FLIST contains the sir ing 

FILEB,FIL EC/LIST, FILED 
then the command 

.COMPILE FILEA,FILEB,FILEC/LIST,FILED,FILEZ 
could be replaced by 

.COMPILE FILEA,@aiST,FILEZ 

Command files may contain the @ file construction to a depth of nine levels. If this process of in- 
direction results in files pointing in a loop, the maximum depth is rapidly exceeded and an error mes- 
sage is produced . 

The following rules apply in handling format characters in a command file. 

a. Spaces are used to delimit words but are otherwise ignored. Similarly, the characters 
TAB, VTAB, and FORM are treated like spaces. 

b. To allow long command strings, command terminators (CARRIAGE RETURN, LINE FEED, 
ALTMODE) are ignored if the first nonblank character after a sequence of command 
terminators is a comma. Otherwise, they are treated either as commas by the COMPILE, 
LOAD, EXECUTE, and DEBUG commands or as command terminators by all other 
COMPIL-class commands. 

c. Blank lines are completely ignored because strings of returns and line feeds are considered 
together. 

d. Comments may be included in command files by preceding the comment with a semicolon. 
All text from the semicolon to the line feed is ignored. 

e. If command files are sequenced, the sequence numbers are ignored. 

2 
1.5.2 The + Construction 

A single relocatable binary file may be produced from a collection of input source files by the "+" 
construction. For example: a user may wish to compile the parameter file, PAR. MAC, the switch file, 
SWIT.MAC, and the file that is the body of the program, MAIN. MAC. This is specified by the 
following command: 

. COMPI LE PAR+SWIT+MAI N 



^However, if BLISS, SNOBOL, and MACX11 (the PDP-11 assembler for the PDP-10) are added as 
processors, one less level of indi recti ng for each processors obtained. These processors will be 
recognized only when the appropriate assembly switches are set. These assembly switch settings are 
not supported . 

2 ~Use in COMPILE, LOAD, EXECUTE, and DEBUG commands only. 
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The name of the last input file in the string is given to any output (.REL, .CRF, and/or .LST) files 
(e.g., MAIN in the preceding example). The source files in the "+" construction may each con- 
tain device and extension information and project-programmer numbers. 

1 .5 .3 The = Constructioh 

Usually the filename of the relocatable binary file is the same as that of the source file, with the ex- 
tension specifying the difference. This can be changed by the "=" construction, which allows a file- 
name other than the source filename to be given to the associated output files, for example: if a 
binary file named BINARY. REL is desired from a source program named SOURCE. MAC, the following 
command is used . 

.COMPILE BINARY=SOURCE 

This technique may be used to specify an output name to a file produced by the use of "+" construction, 
To give the name WHOLE. REL to the binary file produced by PARTI .MAC and PART2.MAC, the fol- 
lowing is typed. 

.COMPILE WHOLE=PARTl+PART2 

Although the most common use of the "=" construction is to change the filename of the output files, 
this technique may be used to change any of the other default conditions. The default condition for 
processor output is DSK:source. REL [self] . For example: if the output is desired on DTA3 with the 
filename FILEX, the Following command may be used: 

EXECUTE DTA3:FILEX=FILE1.F4 

1.5.4 The <> Construction 

The <> construction causes the programs within the angle brackets to be assembled with the same 
parameter file. If + Is used, it must appear before the <> construction. For example to assemble the 
files LPTSER.MAC, PTPSER. MAC, and PTRSER.MAC, each with the parameter file PAR.MAC, the 
user could type 

.COMPILE PAR+LPTSER, PAR+PTPSER, PAR+PTRSER 
With the angle brackets, however, the command becomes 

.COMPILE PAR-KLPTSER, PTPSER, PTRSER > 
However „ the following command is invalid: 

. COMPI LE < LPTSER, PTPSER, PTRSER >+PAR 



^ed in COMPILE, LOAD, EXECUTE, and DEBUG commands only. 
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1 .5.5 Compile Switches 

The COMPILE, LOAD, EXECUTE, and DEBUG commands can be modified by including switches in the 
command string. These switches can be used to indicate the processor to be used, to force a compila- 
tion, to generate listings, to create libraries, to search user libraries, and to obtain loader maps. 
Each switch is preceded by a slash and terminated with a non-alphanumeric character, usually a space 
or a comma. The switch used can be abbreviated if the abbreviation uniquely identifies the switch. 

The switches used with these four commands are either temporary or permanent. A temporary switch 
applies only to the file immediately preceding it. An intervening space or comma cannot separate the 
filename and the switch. For example, 

.COMPILE PROG, TEST/MACRO, SUBLET 

The /MACRO switch applies only to the file named TEST. 

A permanent switch applies to all files following it until modified by a subsequent switch. It is sepa- 
rated from the fileJsy spaces, commas, or a combination of both. For example, 

.COMPILE PROG /MACRO TEST,SUBLET 
.COMPILE PROG, /MACRO, TEST,SUBLET 
.COMPILE PROG, /MACRO TEST, SUBLET 
.COMPILE PROG /MACRO, TEST, SUBLET 

In all four examples, the /MACRO switch applies to the files named TEST and SUBLET. 

The switches that can be used with the COMPILE, LOAD, EXECUTE, and DEBUG commands are de- 
scribed in the individual command explanations in Chapter 2. 

1.5.6 Standard Processor 

Files with recognizable processor extensions (e.g., .MAC, .CBL, ,F4, .ALG) are always translated 
by the processor implied by the extension. For example, a file named DATPRO. CBL will be proces- 
sed by the COBOL compiler. Files without a recognizable processor extension are compiled or assem- 
bled according to the standard processor, which is normally FORTRAN at the beginning of the command 
string. The user can control the setting of the standard processor by including switches in the 
COMPILE, LOAD, EXECUTE, or DEBUG command string. Refer to the appropriate command descrip- 
tions inV Chapter 2 for the switches used to change the standard processor. 



By setting the appropriate assembly switches, SNOBOL, BLISS, and MACX11 (the PDP-11 assembler 
for the PDP-10) will be recognized as processors. However, these assembly switch settings are not 
supported . 
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In the following examples, the installation has chosen FORTRAN as the standard processor. The 

command 

.COMPILE NOEXT 

causes the file named NOEXT (with a null extension) to be compiled by FORTRAN. The command 

.COMPILE FILEZ.MIN 

also compiles the file with FORTRAN since .MIN is not recognized as a processor extension. The com- 
mand 

.COMPILE APART, DATA/COBOL, TEST 
causes the files APART and TEST to be compiled by FORTRAN and the file DATA by COBOL. 

The switches used to change the standard processor can be temporary or permanent switches (refer to 
Paragraph 1.5.5). For example, 

• COMPILE APART, /COBOL DATA, TEST 

causes APART to be compiled by FORTRAN, and DATA and TEST to be compiled by COBOL. 

Note that if source files are specified with the appropriate extensions, the subject of the standard 
processor can be disregarded, since files; with processor extensions are always translated by the proces- 
sor implied. 

1.5.7 Processor Switches 

Occasionally it is necessaryto pass switches to the assembler or compiler being used in a COMPILE, 
LOAD, EXECUTE, or DEBUG command. For each translation (assembly or compilation), the COMPIL 
program sends a command string to the translator containing three parts: the source files, a binary 
output file, and a listing file. To incluae switches with these files, the user must: 

a. If the + construction is used , group the switches according to each related source file. 

b. Group the switches according to the three types of files (source, binary, and listing) for 
each file. 

c. For each source file, separate the groups of switches by commas. 

d. Enclose all the switches for each source file within one set of parentheses. 

(SSSS) Only source switches are present. 

(SSSS,BBBB) Source and binary switches are present. 

(SSSS, BBBB, LULL) Source, binary, and listing switches are present. 

e. Place each parenthesized string immediately after the source file to which it refers. 

The processor switches are listed in Table 1-2, along with their meanings and the types of files to 
which they apply. 
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Table 1-2 
Processor Switches 



Processor 



ALGOL 



Source 



Binary 



Listing 



COBOL 



E 

L 

Q 
S 



E 
L 
M 



M 



S 

W 



W 

z 



FORTRAN 



T 

W 



T 

W 

z 



Meaning 



N 



A 
C 



M 
N 



W 

Z 



A 
B 
C 
D 
E 



M 
N 



T 

W 

z 



Set dynamic storage region for own arrays 

(known as the heap) . 

The source file has line numbers in columns 

73-80. 

List the source program. 

Suppress the error print out on the terminal . 

Delimit the words in quotes. 

Suppress the listing of the source program. 



Allow the listing of code generated. 
Produce a cross-referenced listing of all user- 
defined items in the source program. 
Check the program for errors but do not gene- 
rate code. 

Use the preceding file descriptor as a library 
file whenever the COPY verb is encountered. 
Print a map showing the parameters of the user- 
defined item. 

Suppress output of source errors on the terminal . 
Do not generate trace calls and symbols. 
Produce a two-segment object program. The 
high segment contains the resident sections of 
the Procedure division; the low segment con- 
tains everything else. When the object program 
is loaded, LIBOL is added to the high segment. 
The source file has sequence numbers in columns 
1-6 and comments starting in column 73. 
Rewind the magnetic tape. 
Zero the DECtape directory. 



Advance magnetic tape reel by one file. 
Backspace magnetic tape reel by one file. 
Generate a CREF-type cross-reference listing. 
List error message codes only. 
Print an octal listing of the binary program in 
addition to the symbolic listing. Must be ac- 
companied by /M. 

Translate the letter D in column 1 as a space 
and treat the line as a normal FORTRAN state- 
ment . 

Include MACRO coding in output listing. 
Suppress output of error messages on the terminal . 
Produce code for execution on the KA10 if run- 
ning on the KI10, and vice-versa. 
Skip to the logical end of magnetic tape. 
Rewind the magnetic tape. 
Zero the DECtape directory. 



(continued on next page) 
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Processor 



MACRO 



Source 



Binary 





o 


o 






p 


p 






Q 


Q 






T 


T 






W 


W 

z 





Table 1-2 (Cont) 
Processor Switches 



Listing 



A 
B 
C 

E 
F 
G 
L 

M 

N 
O 
P 
Q 

S 

T 
W 
X 

z 



Meaning 



Advance magnetic tape reel by one file. 
Backspace magnetic tape reel by one file. 
Produce listing file in a format acceptable as 
input to CREF. 
List macro expansions. 

Byte sizes match the format of the instruction. 
Byte sizes are two 18-bit fields. 
Reinstate listing (used after list suppression by S 
switch). 

Suppress ASCII text in macro and repeat expan- 
sion (SALL). 

Suppress error printouts on the terminal . 
Allow literals to occupy only one line. 
Increase the size of the pushdown list. 
Suppress questionable (Q) error indications on 
the listing. 
Suppress listing. 

Skip to the logical end of magnetic tape. 
Rewind the magnetic tape. 
Suppress all macro expansions. 
Zero the DECtape directory. 



Examples: 

.DEBUG TESIT(N) Suppress typeout of errors during assembly . 

•COMPILE OUTPUT*MTA0:CW,S,M>/L Rewind the magtape (W), compile the first file, 

produce binary output for the KI10(S), and in- 
clude the MACRO coding in the output listing 
(M). Output files are given the names 
OUTPUT. REL and OUTPUT. LST. 

•COMPILE/MACRO A=MTA0 : C W, ,Q )/L Rewind the magtape (W), .compile the first file, 

and suppress Q (questionable) error indications on 
the listing. Note that when a binary switch is not 
present, the delimiting comma must appear. 

•COMPILE /MACRO A=MTA0: (;.,Q)/L Compile file at current position of the tape and 

suppress Q error indications on the listing. Note 
that when the source and binary switches are not 
present, the delimiting commas must appear, 

1.5.8 LOADER Switches 

In complex loading processes, it may be necessary to pass switches to the LOADER to direct its opera- 
tion. This is accomplished by the % character. The % has the same meaning as that of the / in the 
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LOADER'S command string (refer to the LOADER documentation). Also, like the /, the % takes a 
leading sign (+ or -) and one letter (or a sequence of digits and one letter) following it. Therefore, to 
set a program origin of 6000 for program C, the user types 
.LOADA,B,%6000OC,D 

The COMPIL program allows more than one LOADER switch to be specified . For example: 

.LOAD PROG %F/MAP 
Refer to the LOAD command in Chapter 2 for a description of /MAP. 

The most commonly used LOADER switches are: 

a. %S Load with symbols. 

b. %nO Set program origin to n. 

c. %F Cause early search of the default libraries. 

d. %P Prevent search of the default libraries. 
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CHAPTER 2 
SYSTEM COMMANDS AND PROGRAMS 



Although there is one operating system for all configurations of the DECsystem-10, some commands 
may not be included in each DEGystem-10. This is especially true of the DECsy stem- 1040, the basic 
system intended for small installations that do not want all of the system's features because of a con- 
straint on core. Commands are deleted from the DECsystem-1040 by feature test switches (recognized 
by the beginning characters FT) defined at MONGEN time. In the standard DECsystem-1040, many 
of these switches are not set and, therefore, the corresponding commands are not available., This saves 
core but limits various features of the operating system . In the command descriptions that follow, the 
Characteristics section indicates if the switch is normally off in the DECsystem-1040. If not stated, 
the command is available on all DECsy stem- 10s. 

In many cases, there are two commands to run a program. For example, the indirect command MAKE 
and the direct command R TECO both run the TECO program. In the DEGystem-1040, the switch 
implementing the indirect command may not be set but the switch implementing the direct command is 
always set. Therefore, it is always possible to run a program with the .R or .RUN command, even 
if the switch implementing the corresponding indirect command is off. 

2.1 COMMANDS BY FUNCTIONAL GROUPS 

Although the commands are arranged in alphabetical order for ease of reference, they can be divided 
into functional groups for ease of learning. These groups with their associated commands are as follows. 

2.1.1 Job Initialization Commands 

Since the system is limited to authorized persons, these commands protect the system from unauthorized 



use. 



INITIA 
LOGIN 
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2.1.2 Faci lily Allocation Commands 

The monitor allocates peripheral devices, file structure storage, and core memory to users on request 
and protects these allocated facilities from interference by other users. Software provisions are incor- 
porated in the monitor to differentiate the central station from the remote stations. Certain monitor 
commands, for example, ASSIGN and PLEASE, include station identification arguments to allow both 
user-access and allocation of system resources at any station. This feature gives the user considerable 
flexibility in allocating system facilities and directing input and output to the station of his choice. 
For example, by specifying a station number, the user can assign devices and input data from a periph- 
eral device at a station other than his own. In addition, by using the LOCATE command, he can 
logically establish his job at a station other than his physical station. If the station identification 
argument is not included in a command, the system automatical ly directs input and output to the user's 
logical station. The user's logical station is the same as his physical station if he has not issued the 
LOCATE command. 

When a nonsharable device is; assigned to a job, it is removed from the monitor's pool of available re- 
sources. Any attempt by another user to reference or assign the device fails. Thus, a user should 
never leave the system without first returning his allocated facilities to the monitor pool . Allocated 
facilities are automatically returned to the monitor pool when the user deassigns them or kills his Job. 
Until a user returns these facilities, no other users may utilize them except through operator interven- 
tion . 

Assignable devices (i.e., nondisk and nonspooled devices) in the monitor's pool of available resources 
are designated as being either unrestricted or restricted devices. An unrestricted device can be as- 
signed (ASSIGN command or INIT UUO) by any user. A restricted device can be assigned only by a 
privileged job (i.e., a job logged in under £1,2] or running with the JACCT bit set). However, a 
nonprivileged user can have a restricted device assigned to him via the MOUNT command. This com- 
mand allows operator intervention for the selection or denial of a particular device; thus the operator 
can control the use of the assignable devices. This is particularly useful when there are multiprogram- 
ming batch and interactive jobs competing for the same devices. The restricted status of a device is set 
or removed by the OPSER commands RESTRICT and :UNRESTRICT. 

The facility allocation commands are as follows: 



ASSIGN 
CLOSE 
CORE 
DEASSIGN 



DISMOUNT 
FINISH 
LOCATE 
MOUNT 



REASSIGN 
SET BLOCKSIZE 
SET CDR 
SET CPU 



SET DENSITY 
SET DSKPRI 
SETHPQ 
SET SPOOL 
SET TTY or TTY 
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2.1.3 Source File Preparation Commands 

These commands call the system editing programs in order to create or edit a specified text file. The 
system editing programs available are LINED (a line-oriented editor) and TECO (a character-oriented 
editor). In general, the editor used to create the file should be used for editing, since LINED requires 
line-blocked files and TECO does not. 

CREATE 
EDIT 
MAKE 
TECO 



2.1.4 File Manipulation Commands 

The commands in this group allow the user to manipulate his files to any desired extent. He can list 
source files, and DECtape and disk directories on the terminal or the line printer, possibly via the 
spooling mechdnism. He can delete or rename files from disk and DECtape. In addition, the user can 
transfer files between standard I/O devices, perform conversion between various core image formats, 
and read and write various directory formats. Disk space can be either allocated for a new file or re- 
allocated for an existing file. Finally, the user can place files in the system queues and obtain listings 
of entries in those queues. 



ALCFIL 

BACKSPACE 

BACKUP 

COPY 

CPUNCH 

DELETE 



DIRECT 

EOF 

FILE 

FILEX 

LIST 

PLOT 



PRESERVE 

PRINT 

PROTECT 

QUEUE 

RENAME 

RESTORE 



REWIND 

SKIP 

SUBMIT 

TPUNCH 

TYPE 

UNLOAD 

ZERO 



2.1.5 Object Program Preparation Commands 

The commands in this group are used to prepare object programs and save the user's core area as one or 



two files. 



COMPILE 

CREF 

DEBUG 



EXECUTE 

FUDGE 

FUDGE2 



LOAD 
SAVE 
SSAVE 



2.1.6 Object Program Control Commands 

By using the commands in this group, the user can load core image files from retrievable storage de- 
vices (i.e., disk, DECtape, magnetic tape). These files can be retrieved and controlled from the 
user's terminal . Files stored on disk and DECtape are addressable by name. Hies on magnetic tape 
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require the user to pre-position the tape to the beginning of the file. Refer to DECsystern -10 Monitor 
Calls, Chapter 1 , for a description of the job data area locations referenced by the command descrip- 
tions in this group. 

CONT(CCONT) HALT REENTER 

DDT JCONT run 

GET R START (CSTART) 

2.1.7 Object Program Examination Commands 

The commands in this group aid the user In examining and analyzing his object program. Dumps of the 
user's core area can be taken and later processed by the system program DUMP according to the argu- 
ments specified by the user. 

D (deposit) 

DCORE 

DUMP 

E (examine) 



2. 1 .8 Multiple Job Control Commands 

There is not necessarily a one-to-one relationship between jobs and terminals. A terminal must initiate 
a job, but the user or operator may issue commands to permit a job to float in a detached state wh< 
it is not associated with a particular terminal. Thus, more than one job may be controlled from th< 
same terminal . 



lere 



AT TACH CSTART OPSER 

CCONT DETACH REATTA 



2.1.9 Job Termination Command 



When the user leaves the system, all facilities allocated to his job must be returned to the monitor 
facility pool so that they are available to other users. 



KJOB 



2.1 .10 Sending Messages 



The commands in this group allow the user interconsole communication with other users of the system 
or with operators at any station. In addition, the user may record information in a disk file to be read 
by the operations staff at a later time. 



GRIPE 

PLEASE 

SEND 
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2.1.11 Job Information Commands 



The user can obtain various job-related information with this group of commands. This information 
includes the number of his job, the quotas for each file structure associated with his Job, and the run- 
ning time and disk space that his job has used. In addition, the user may type or modify his file struc- 
ture search list. 

DSK QUOLST SET TIME 

PJOB SETSRC SET WATCH 

TIME 



2.1.12 System Information Commands 

With the commands in this group, the user is able to obtain system status information, including the 
time of day, the list of available devices, file structures, and physical units not in file structures, the 
scheduled use of the system, and the location of a specific peripheral device. 

DAYTIME SCHED VERSION 

RESOURCES SYSTAT WHERE 
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ALCFIL program 



Function 



The ALCFIL program enables the user to allocate space for a new file or reallocate space 
for an existing file in one contiguous region on the disk. The size of the region is restricted 
by the size of the cluster count field (usually 512) times the cluster size of the file structure 
times the number of pointers in o disk device data block (not less than 10). 



Command Format 



R ALCFIL 

The ALCFIL program responds with 

/H FOR HELP 
FILE? 

The user may respond with 

dev:file.ext [pro j, prog] 
or /H (for help) 
or /X (to exit) 

where dev: is a file structure or physical unit name. If dev: is omitted, DSK is assumed. 
If one of the other arguments is omitted, is assumed . If a filename is specified, the 
number of blocks presently allocated, if nonzero, is typed. ALCFIL responds with 

ALLOCATE? 



User may type N or N,M (decimal numbers) 



N - total number of blocks to be allocated for the file. 
M = logical block within the file structure or unit (depending on dev:) 
where the allocation is to begin. 

If the total number of blocks requested cannot be allocated (because of disk quotas), 
a partial allocation is given and the message 

PARTIAL ALLOCATION ONLY 
is typed. The user can issue -the DIRECT command with the ALLOCATE switch to 
determine the number of blocks allocated. If the new blocks can be allocated, 
the message 

ALLOCATED 

is typed . 

Since an extended ENTER (refer to DECsystem-10 Monitor Calls ) is executed to 
allocate the new blocks, the file need not exist before the blocks are allocated. 
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ALCFIL program (Cont) 



Characteristics 

The R ALCFIL command: 

Places the terminal in user mode. 

Runs the ALCFIL program, thereby destroying the user's core image, 

Associated Messages 

Refer to Chapter 4. 

Example 

•R ALCFIL J 

/H FOR HELP 
FILE? TEST4.TST^ 
ALLOCATE? 2000^ 

ALLOCATED 

FILE? TESTS. ISlJ 

ALLOCATE? 1000J 

ALLOCATED 

FILE? TEST5.TST^ 

1000 BLOCKS ALREADY ALLOCATED 

ALLOCATE? 500 J 

ALLOCATED 

F I LE ? DSKBrFILEA^ 

ALLOCATE? 3000 J 

PAriTIAL ALLOCATION ONLY . 
F I LE ? /X 

EXIT " 

•DIK/ALLOC^ 

FILEA 175 <057> 14 -APR -72 DSKB: 
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ASSIGN command 



Function 



The ASSIGN command allocates an I/O device to the user's job for the duration of the job or 
until a DEASSIGN command is given. This command, applied to DECtapes, clears the copy 
of the directory currently in core, forcing any directory references to read a new copy from 
the tape. (Refer to DECsystem-10 Monitor Calls for further details.) 

Although DECtape is the only device that should be ASSIGNed before use, to ensure that the 
monitor has a copy of the proper DECtape directory in its core area, it is wise to ASSIGN all 
devices, such as magnetic tape, before use. 



Command Formats 



1. ASSIGN phys-devn log-dev 

phys-devn = any physical device listed in Table 1-1 in Paragraph 1 .4.2.2, followed by 
a l-to-3 digit number representing a specific unit, or any file structure name. This argu- 
ment is required. With this command format, the monitor attempts to assign the device 
specifically requested. If unable to assign the device, the monitor types an appropriate 
message (refer to Chapter 4). 

log-dev - a logical name assigned by the user. This argument is optional . Except for 
disk devices, only one logical name can be assigned to a physical device. Subsequent 
ASSIGN commands to all devices except disk devices replace the old logical name with 
the new one. Logical names are disassociated from all devices by the DEASSIGN com- 
mand. 

2. ASSIGN phys-devSnn log-dev 

phys-devSnn = any physical device followed by the letter S and a 1 or 2 digit number 
representing a specific station, or any file structure name. This argument is required. 
With this command format, the monitor attempts to assign a device at the requested 
station . An appropriate message is typed if the device cannot be assigned (refer to 
Chapter 4) . 

log-dev = same as above . 

3. ASSIGN phys-dev log-dev 

phys-dev = any physical device followed by a null argument implying any device of the 
designated type, or any file structure name. This argument is required. With this com- 
mand format, the monitor attempts to assign the requested device at the user's logical 
station. If this type of device does not exist at the user's logical station, the monitor 
attempts to assign the device at the central station. If unable to assign the device, the 
monitor types an appropriate message (refer to Chapter 4). 

log-dev := same as above . 
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ASSIGN command (Cont) 



Characteristics 



The ASSIGN command: 

Leaves the terminal in monitor mode. 



Restrictions 



A comma may not be used to separate the logical and physical device names. If a comma is 
used, the monitor terminates its scan at the comma; therefore, the logical name is not assigned, 

Non-privileged jobs (i.e., |obs not logged in as [1,2] or running with JACCT set) can only 
use this command to allocate unrestricted I/O devices. Restricted devices can be obtained by 
non-privileged jobs via the MOUNT command. The ASSIGN when issued by a privileged job 
allocates both restricted and unrestricted devices. 



Associated Messages 



Refer to Chapter 4. 



Examples 



_»ASSIGN LPJ2.1J 
LPT2 ASSIGNED 



The user assigns a specific line printer (LPT2). 



^AS CDRS2:J 
CDR4 ASSIRNFf) 



The user assigns any available card reader at 
station 2. 



^assign ttyi:lpt:^ 

TTYl ASSIGMFD 



The user assigns TTY 1 and gives it logical name 
LPT. 



.AS LPl'.J 
LPT4 ASSIGNED 



..ASSIGN DTA?:^ 
?DEVICE NOT ASSIGNABLE 



.ASSIGN DTA:J 
DTA4 ASSIGNFD 



The user assigns any available line printer. The 
LPT chosen is at either the user's station or the 
central station. 

A non-privileged user attempted to allocate a re- 
stricted device (DTA2). 

The user then uses the generic device name (DTA) 
to obtain the device. He could have used the 
MOUNT command to assign the restricted device 
DTA2. 
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ATTACH command 



FuncHon 



The ATTACH command detaches the current job, if any, and connects the terminal to a 
detached job. 



Command format 



ATTACH job [proj,prog] 

job = the job number of the job to which the terminal is to be attached. This argument 
is required. 

[proj,prog] = the project-programmer number of the originator of the desired job. This 
argument may be omitted if it is the same as the job to which the terminal is currently 
attached. The operator (device OPR) or a user logged-in under [1,2] may always 
attach to a fob although another terminal is attached, provided he specifies the proper 

[pro |, prog]. 

To prevent users from attaching the jobs without knowing the PASSWORD associated with the 
job, a new job is temporarily created when the [proj,prog] argument is specified. This tem- 
porary job runs LOGIN to check the password. This can result in the current job not being 
able to attach to the specified job if the job capacity of the system would be exceeded with 
the creation of the temporary job. However, the current job is still detached even if there 
are no available jobs. The operator or any job logged-in as [1 ,2] can always attach to 
another job since they do not require the creation of a temporary job. 



Characteristics 



The ATTACH command: 

Leaves the terminal in monitor mode. 

Does not require LOGIN. 

Depends on FTATTACH which is normally absent in the DECsystem-1040, 



Restrictions 



Remote users cannot attach to jobs with a project number of 1 . Batch users cannot issue this 
command . 



Associated Messages 



Refer to Chapter 4. 
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ATTACH command (Cont) 



Examples 



.ATT \J 

From job 5 



The user attaches to job 1 from job 5. The two jobs 
have the same [proj, prog] and therefore, the argument 
is not required. 



2. 



.LOG 27,235^ 
TOB 7 3S04 TTY25 

1634 23-FEB-72 WED 

^ATTACH 36 £50,27jJ 
FBQM JOB, 7 

password; 



^ATTACH 7J 

?CAN'T ATT,TQ._,J,p6,. 



The user logs-in and is given job 7, 
attached to job 7 . 



TTY25 is now 



The user attaches to an existing job (36) and there- 
by detaches his current job (7). Since the [proj, 
prog] associated with job 36 is different than the 
user's, he must specify the [proj, prog] of the de- 
sired job. The system then requests the PASSWORD, 
If the given PASSWORD is correct, the terminal is 
attached to job 36, 

The terminal is attached to job 36. 

The user attempts to attach to job 7. The command 
fails because the [proj, prog] of job 7 is not the % 
same as the [proj, prog] of job 36. The terminal is 
still attached to job 36. 



JOB 36, USER [S0,273 LOGGED OFF TTY25 1035 23-FEB-72 

RUNTIME 0MIN,00.34SEC T .... , . , ~, ZT , . . . ,. 
■ The user killed job 36. The terminal is currently 

not attached to any job. 



.ATTACH 7j 
TtAN'T ATT TO JOB 



.ATTACH 7 [27,2353^ 



Since the terminal is currently not attached to a 
job, the command fails because there is no [proj, 
prog] to compare with the [prof, prog] of job 7. 

The command is accepted and the PASSWORD is re- 
quested. The message FROM JOBn is not output 
since the terminal was not attached to a job. 

The terminal is attached to job 7. 
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BACKSPACE command 1 



Function 

The BACKSPACE command spaces a magnetic tape backward a specified number of files or 
physical records. This command, depending on its arguments, is equivalent to the following 
PIP command strings: 

MTAn: (M #nB) *- 
MTAn: (M #nP) - 

Command formats 

1 . BACKSPACE MTAn: x FILES 

skips backward x files. 

2. BACKSPACE MTAn: x RECORDS 

skips backward x records. 

Characteristics 

The BACKSPACE command: 

Leaves the terminal in monitor mode. 

Runs the PIP program. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 

Associated Messages 

Refer to Chapter 4 . 

Examples 



^8AC f^TA2J 7 RECORDS^ 
^BACKSP MTA3J 11 FILES,) 



This command runs the COMPIL program, which interprets the command before running the PIP 
program . 

Version 20 COMPIL 2 -12 

Version 32 PIP 
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BACKUP program 



Function 



The BACKUP program enables the user to save disk files on magnetic tape (MTA), DECtape 
(DTA), or disk (DSK). The save can be of the entire disk or selected subsets of the disk. 

The BACKUP program places data in the following files: 

1. BACKUP SET file 

This file contains the data saved on the backup medium (MTA, DSK, DTA) with 
one BACKUP command. When data is saved on disk, the BACKUP SET file is one 
file with file delimiting control words. When written on magnetic tape, it is 
several files written in buffered binary mode. 

The BACKUP SET file is composed of a BACKUP header, a user set, and a 
BACKUP trailer. The BACKUP header is one block in length and contains infor- 
mation concerning the creation of the BACKUP SET. This information includes the 
name and date of creation, the name of the system, and the user identification. 

The USER SET contains the directories and the files associated with the directories 
for all user areas. Even if a user, has files on more than one file structure, his 
files will be saved together. For example, all files on all file structures for user 
1 ,2 will be stored before the files for user 1 ,3. In other words, the user set is 
ordered according to project-programmer number, not according to file structures. 
However, within individual project-programmer numbers, all files on one file 
structure are saved before files on another. 

The BACKUP trailer contains information about the user set that was just created. 
This information includes the time, the date, and the length of the user set. The 
BACKUP trailer immediately follows the user set. 

2. INDEX file 

This file contains the directories and the filenames of all the disk areas that have 
been saved on the backup medium. In addition, it contains the relative block 
number in the BACKUP SET file where each element (file) begins. The index file 
is the last file written on the backup medium and is separated from the BACKUP 
SET file. It can be saved on DECtape and can be listed, if desired. 

3. COMMAND RECOVERY file 

This file contains information that indicates how much of the user's command has 
been processed and how much of the command remains. It is updated at every 
check point in order to make crash recovery possible. 

4. Log File 

The user is given a log file to aid him in error analysis. This file contains a 
record of either all actions performed by the BACKUP and RESTORE programs or 
only errors encountered in processing. The log file is a listing file. 
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BACKUP p rogram (Contj] 



Command Format 



R BACKUP 



The user may type any of the following commands after the slash output by the BACKUP 
program. These command;; are stored in core and are processed only when a START 
command is given by the user. All commands are terminated with a carriage return. 
Multiple files may be specified in one command string by separating the filenames 
with commas. The full wildcard construction may be used to replace the filename, the 
extension, or the director/ (refer to Paragraph 1 .4.2.4). 



Command 



BACKSPACE FILE 



BACKSPACE SET , 



BACKSPACE UFD 



BACKUP dev2: file descriptor 
devl: [pro j, prog] /switch 



DELETE dev: file.ext 



DENSITY MTAnrx 



DUMP ON dev: file.ext 



ERROR DUMP dev: 



Explanation 

Backspaces the magnetic tape to a user file header and positions 
the tape immediately before the header. 

Backspaces the magnetic tape to a BACKUP header and positions 
the tape either immediately before the header or to the begin- 
ning of the tape if there is no BACKUP header (? .e. , there is 
only one BACKUP SET on the tape). 

Backspaces the magnetic tape to a UFD header and positions the 
tape immediately before the header. 

Writes the designated file on dev2 from devl . The user may 
specify files to be taken from and/or written to a user's area 
other than his own, provided that he has access privileges to 
the user areas. The device arguments are required. 

/switch = /EXCEPT file descriptor 

Indicates the files and/or areas that should not be written as 
BACKUP files. 

Deletes the file named from the specified device. The specified 
device must be the device for which a BACKUP has been taken. 

Sets the magnetic tape density as specified by x. 



= 2 


200 bpi 


= 5 


556 bpi 


= 8 


800 bpi 



The default is the system standard defined at MONGEN time. 

Dump the contents of the BACKUP set file beginning at the 
present position and ending at the next file control word. All 
types of errors are ignored. The device on which the dump is 
to be written may not be a listing device. 

Returns to the last file control word and dumps the file on the 
device specified if a transmission error occurs during the backup 
of any file. 



(continued on next page) 
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BACKUP program (Cont) 



Command 



INDEX dev: file.ext 



LOG dev: file.ext /switch 



PARITY dev: ODD or EVEN 



REWIND dev: 



START 



UNLOAD dev: 



Explanation 

Writes the index file with the designated filename on the device 
named. The index file is also written on the disk and saved as 
the last file on the backup medium. The default is 
DSK:MTnnnn.BKP where nnnn corresponds to the tape sequence 
number. 

Writes a file on the specified device which contains a record of 
the operations performed. The default is DSK:BACKUP.LOG. 

/Switch = /ERROR 

Logs only the errors. This switch is optional . If omitted, all 
operations are recorded . 

Specifies the parity on magnetic tape as odd or even. The de- 
fault is odd . 

On magnetic tape, closes the backup set and rewinds the tape. 
On disk, closes the backup set. 

Begins execution of a series of commands sent previously . Com- 
mands are not processed until a START command is given. If 
there are no commands to be processed when the START is exe- 
cuted, the command recovery file is searched for executable 
commands. 

Performs a rewind and unload to magnetic tape. 

The user may restart the BACKUP program at any time. By issuing a tC tC START 
sequence, the user can cancel present operations and specify new commands. A 
tC START sequence deletes the command recovery file if the next command given to 
the BACKUP program is not START. If START is the next command to BACKUP, the 
command recovery file is scanned, and the BACKUP program continues according to 
the information in the file. A tC CONT sequence does not delete the command 
recovery file, but completes the current requests. After all requests have been com- 
pleted, the BACKUP program closes out the log file,. and types BACKUP COMPLETED 
and an asterisk on the user's terminal indicating that it is ready for more requests. 

MTA rewinds due to the magnetic tape being filled are actually rewind and unload 
operations to insure that the magnetic tape is not overwritten. When the BACKUP pro- 
gram reaches completion, the magnetic tape last written on remains in position unless 
a REWIND command is given. 



Characteristics 



The R BACKUP command: 

Runs the BACKUP program, thereby destroying the user's core image. 
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BACKUP program (Cont) 



Associated Messages 

Refer to Chapter 4, 
Examples 

^P BACKUP^ 

/BACKUP f*TAl :-DSKB: [10.2253 *.* J 
ZlNOEX 03KC:BAKFIL.LSTJ 
/STARTS 



JSBACKUP CQHPjETED AT 16»45!22 
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CLOSE command 



Function 



The CLOSE command terminates any input or output currently in progress on the specified de- 
vice, and automatically performs the CLOSE UUO (refer to DECsystem-10 Monitor Calls ). 
Files are CLOSEd, but not RELEASEd, and logical names and device assignments are preserved 
Since most programs CLOSE files when they finish performing a command string, the CLOSE 
command is provided for the occurrence of a program not terminating or a program being de- 
bugged. This command causes any disk files being written to be entered into the user's UFD. 
If a CLOSE is not done, the next RESET by a command (R, RUN, GET) or program will delete 
the partially written file. 



Command Format 



CLOSE dev 



dev - the logical or-physical name of the device on which I/O is to be terminated. 
This argument is optional . 

If dev is omitted, I/O is terminated on all devices, except for the job's controlling 
terminal, and all files are CLOSEd. 



Characteristics 



The CLOSE command: 



Leaves the terminal in monitor mode. 

Requires core. 

Depends on FTFINISH which is normally absent in the DECsystem-1040. 



Restrictions 



The user cannot continue, but can start at the beginning or enter DDT. 

Associated Messages 

Refer to Chapter 4. 

Examples 

^CLOSE PTRj^ 
7CL0SE OEVAt^ 
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COMPILE command 1 



Function 



The COMPILE command produces relocatable binary files (.REL files) and/or compilation list- 
ings for the specified source program files. The assembler or compiler used is determined by 
the source file extension or by switches in the command string. If no switches appear in the 
command string, the following translators are used: 

Source File Extension Translator Used 

.ALG ALGOL compiler 

.BLI BLISS compiler 2 

.CBL COBOL compiler 

.F4 FORTRAN compiler (F40) 

.MAC MACRO assembler 

.PI 1 MACX11 assembler 2 

.SNO SNOBOL compiler 2 

Other than above, or null Standard processor, which is usually FORTRAN at 

the beginning of the command string (refer to 

Paragraph 1 .5.6). 

NOTE 
If a source file has a recognizable processor extension (see 
above), the processor cannot be changed with a switch. The 
only time that a processor can be specified with a switch is 
when the source file has a non-recognizable processor exten- 
sion or a null extension . 

Normally the source file is translated if there is no corresponding binary (.REL) file or if the 
source file's date and time is later than or equal to the binary file's date and time. If the 
binary file is newer than the source file, the source file is not translated and the current .REL 
file is used. However, switches can be used to override this action. 

Each time the COMPILE, LOAD, EXECUTE, or DEBUG command is executed, the command 
with its arguments is remembered in a temporary file on disk, or in core if the monitor has the 
TMPCOR feature. Therefore, the filename used last can be recalled for the next command 
without specifying the arguments again (refer to Paragraph 1 .5). 

The COMPILE command accepts several command constructions: the @ construction (indirect 
commands), the + construction, the = construction, and the < > construction . Refer to 
Paragraph 1 .5 for a complete description of each of these constructions. 



This command runs the COMPIL program, which interprets the command before running the appro- 
priate processor. 

? 
SNOBOL, BLISS, and MACX11 (the PDP-11 assembler for the PDP-10) will be recognized as pro- 
cessors only if the appropriate assembly switches are set. However, these assembly switch settings 
are not supported . 

Version 20 COMPIL 2-18 
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COMPILE command (Cont) 



Command Format 



COMPILE list 



list = a single file specification, or a string of file specifications separated by commas. 
A file specification consists of a device name, a filename with or without an exten- 
sion, and a directory name. 

The following switches can be used to modify the command string. These switches can 
be temporary or permanent switches (refer to Paragraph 1 .5.5). Note that all the 
switches allowed with the LOAD, EXECUTE, and DEBUG commands can be used with 
the COMPILE command. However, only the switches pertinent to COMPILE are listed 
below; the others are ignored . 



/ALGOL 
/BLISS 1 
/COBOL 
/COMPILE 

/CREF 



/FORTRAN 



Compile the file with ALGOL. Assumed for files with the exten- 
sion of .ALG. 

Compile the file with BLISS. Assumed for files with the extension 
of .BLI. 

Compile the file with COBOL. Assumed for files with the exten- 
sion of .CBL. 

Force a compilation on this file even though a binary file exists 
with a newer date and time than the source file. This switch is 
used to obtain an extra compilation (e.g., in order to obtain" a 
listing of the compilation) since normally compilation is not per- 
formed if the binary file is newer than the source file. 

Produce a cross-reference listing file on the disk for each file 
compiled for later processing by the CREF program. These files 
have the filename of the source file and the extension of .CRF. 
The.file can then be listed with the CREF command. However, 
with COBOL files, the cross-referenced listing is always appen- 
ded to the listing file. No additional command need be given to 
obtain the listing. 

Compile the file with FORTRAN. Assumed for files with the ex- 
tension of .F4 and all files with non-recognizable processor ex- 
tensions (if FORTRAN is the standard processor). 



BLISS will be recognized as a processor only if the appropriate assembly switch is set. However, this 
assembly switch setting is not supported. 
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COMPILE command (Cont) 



Command Fo rmat (cont) 
/FUDGE 



/LIST 



/MACRO 
/MACX11 1 
/NO COM PILE 



Create a disk file containing the names of the .REL files produced 
by the command string. When the FUDGE command is given , PIP 
reads this file in order to generate a library REL file. Arguments 
to this switch are: 

/FU DG E:dev :fi I e . ext [pro j , prog] 

dev: - the device on which to write the file. DSK: is assumed. 

file. ext - the name of the library file. The filename is required. 
If the extension is omitted, it is assumed to be .REL. 

[proj,prog] - the directory in which to place the file. The user's 
director/ is assumed if none is given. 

This switch is permanent in the sense that it pertains to all .REL 
files generated by the command string. 

Generate a disk listing file, for each file compiled, with the file- 
name of the source file and the extension of .LST. These files can 
be listed later with the LIST command. Unless this switch is speci- 
fied, listing files are not generated except in COBOL; COBOL 
listings are always generated. 

Assemble the file with MACRO. Assumed for files with extension 
of .MAC. 

Assemble the file with MACX1 1 . Assumed for files with extension 
of .PH. 

Complement the /COMPILE switch by not forcing a compilation on 
a source file whose date is not as recent as the date on the binary 
file. /NOCOMPILE is the default action. 



/NOLIST 



/SNOBOL 



Do not generate listing files. This is the default action except for 
COBOL files; COBOL listings are always generated. 

Compile the file with SNOBOL. Assumed for files with an exten- 
sion of ,SNO. 



SNOBOL and MA CXI I (the PDP-11 assembler for the PDP-10) will be recognized as processors only 
if the appropriate assembly switches are set. However, these assembly switch settings are not 
supported . 
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COMPILE command (Cont) 



Characteristics 

The COMPILE command: 



Leaves me terminal in monitor mode. 
Runs the appropriate processor. 



Restrictions 



The wildcard construction cannot be used. 

Associated Messages 

Refer to Chapter 4 . 

Examples 

^COMPILE PROG, TEST. MAC, MANAGE/COBOL^ 

Compiles PROG (with null extension) with FORTRAN, TEST. MAC with MACRO, and 
MANAGE (with null extension) with COBOL only if REL files do not exist with later 
dates. A listing file is generated only for MANAGE. The files generated are 
PROG. REL, TEST. REL, MANAGE. REL, and MANAGE. LST. 

^COMPILE /LIST SIGN„MAC,TABLES/N0LIST, MULTI.ALG^ 

Compiles SIGN. MAC with MACRO, TABLES (with null extension) with FORTRAN, 
and MULTI.ALG with ALGOL. Listing files are generated for SIGN. MAC and 
MULTI.ALG. 

j^COMPiLE/CREF/COMPILE DIVIDE, SUBTRC, ADDJ 

Forces a compilation of the source files although current .REL files exist and generates 
cross-referenced listing files. The files created are DIVIDE. CRF, DIVIDE. REL, 
SUBTRC. CRF, SUBTRC. REL, ADD. CRF, and ADD. REL. 

^COMPILE /FUDGE :MONITR.REL#L IB ALL J 

Compiles the files contained in the command file LIBALL and enters the names of all 
the REL files generated in a temporary disk file. When the FUDGE command is given, 
PIP generates the library REL file wjth name MONITR.REL. The library is created with 
the REL files in the same order as they were specified in the command file. 
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COMPILE command (Con t) 



Examples (cont) 



^COMPILE OUTPUT*MTA0: CW-, S,M)/LJ 

Rewinds the magnetic tape (W), compiles the first file with FORTRAN, produces binary 
output for the KA10 (S), and includes the MACRO coding in the output listing (M). 
These switches are processor switches (refer to Paragraph 1 .5.7). A listing file is gene- 
rated with the name OUTPUT. LST, along with the file OUTPUT. REL. 
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CONTINUE command 



Function 



The CONTINUE command starts the program at the saved program counter address stored in 
. JBPC by a HALT command (tC) or a HALT instruction . Refer to DECsystem-10 Monitor Calls 
for a description of the job data area. 



Command Format 



CONTINUE 



Characteristics 



The CONTINUE command: 

Places the terminal in user mode. 

Requires core. 

Does not require LOGIN. 



Associated Messages 



Refer to Chapter 4. 



Example 



Mim LOOPj 

tC 

tC 

.DAYTTME^ 

23-FEB-7g 16;33;10 



Run a program called LOOP in your disk area, 

Stop the program. 
Check the time of day. 

Continue the program. 
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COPY command 1 



Function 



The COPY command transfers files from one standard I/O device to another. The command 
string can contain one device output specification and any number of input specifications. 
The equal sign separates the destination (output) side from the source (input) side. This com- 
mand runs PIP and performs the basic PIP function of transferring files. 



Command Format 



COPY dev: file.ext [proj,prog] <nnn>= dev: file.ext [proj,prog], file.ext [proj,prog], ... 

dev: = a physical or logical device name. If the device name is omitted, DSK: is 
assumed . 

file.ext = the name of the file(s) to be used on incut or for output. If the output file- 
name is omitted/ the input filemane is assumed. HIP combines the files if many input 
files are being transferred to one output file. If many input files are being transferred 
to the same number of output files, PIP uses the /X switch to keep the files separate. 
The wildcard construction is allowed. 

[prof, prog] = the disk airea in which either the files are to be read or written. If this 
argument is omitted, the user's default disk area is assumed. The user may transfer files 
to or from another area only if he has access to the area. 

<nnn>= the protection code to be given to the output file(s). If omitted, the system 
standard is assigned. 

Switches can be passed to PIP by enclosing them in parentheses in the COPY command string. 
When COMPIL interprets the command string, it passes the switches on to PIP. 



Characteristics 



The COPY command: 



Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040, 



Associated Messages 



Refer to Chapter 4. 



This command runs the COMPIL program, which interprets the command before running PIP. 
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COPY command (Cont) 



Examples 



.C0PY=DTA3: FILNAM.MAC* MANY.CBL* COMMON. ALG^ 

The three files from DTA3 are transferred to the user's disk area with the same file- 
names. 

.COPY DTA3: OUTPUT=*.*J 

All files in the user's disk are transferred to one file on DTA3 with the name 
OUTPUT. 

.COPY FILEA.*=DTA1 : SOURCE.* J 

The input files on DTA1 named SOURCE with any extension are transferred to DSK with 
the filename FILEA and the same extension. The number of output files equal the 
number of input files. 

^COPY YOURS. CBL [20* 173 = MINE.CBL } 

The file MINE.CBL from the user's disk area is transferred to [20,17] disk area with 
the name YOURS. CBL. The user must have privileges to write in area [20,17] . 
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COPY program 



Function 



The COPY program is a DECtape copy routine that allows the user to 

1 . Copy the entire contents of an input DECtape to an output DECtape. 

2. Zero all blocks on an output DECtape and clear the directory. 

3. Perform a word-by-word comparison of two DECtapes. 

4. Load a bootstrap loader and write it in blocks 0, 1, and 2 of the output DECtape, 



Command Format 



^.R COPY J 

^output DTA:=input DTA: /switches 

/switches = one or more of the following switches. Switches are preceded by a slash 
or enclosed in parentheses and can appear anywhere in the command string. 

/C Copy all blocks from the input DECtape to the output DECtape. 

/G Do not restart the program after a parity error, Output an error mes- 

sage and continue the program. 

/H Type the available switches and their meanings. 

A Load the bootstrap loader into a core buffer. COPY expects the loader 

to be on logical device PTR in the file named BSLDR.REL. Note that 
COPY must be SAVed if the loader is to be preserved with the COPY 
core image., 

/N Suppress the directory listing. 

/T Write the bootstrap loader in blocks 0, 1 , and 2 of the output DECtape. 

This switch accepts, as input from the terminal, a core bank or offset. 
The loader is offset and then written on the tape. 

core bank = nnnK (16K to 256K) 
offset = 1000 to 777600 octal 

/V Verify the similarities of the two DECtapes by performing a word-by- 

word comparison and typing on the terminal the number of discrepancies 
discovered. 

/Z Zero all blocks of the output DECtape and clear the directory. 

/6 Look for the directory in PDP-6 format (i.e., in block one instead of 

block 144). 
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Command format (cont) 



If no switches are specified, /C (copy) and /V (verify) are assumed by default. Note 
that upon completion, the directory in core may not agree with the directory of the 
output DECtape. The output DECtape should be reassigned to guarantee that the 
directory in core is up-to-date. 



Characteristics 



The R COPY command: 

Places the terminal in user mode. 

Runs the COPY program, thereby destroying the user's core image. 



Associated Messages 



Refer to Chapter 4. 



Examples 



L R COPY^ 

*DTA7 : = DTA3 : J 



Run COPY 

Copy the contents of DTA3 to DTA7 and determine 
if the two DECtapes are the same (default condi- 
tion). If the DECtapes disagree, the number of 
discrepancies is typed on the terminal . 

+DTA2 :/Z= J Zero all blocks and clear the directory on DTA2. 

*tC Return to monitor mode. 

^ASS IGN DSKrPTR : J The bootstrap loader must be on logical device PTR. 

.RENAME BSLDH.HEL=DTBOOT.r<EL^ COPY expects the bootstrap loader to be named 

BSLDR. 

.R COPY J Run COPY 

*/L J Load the bootstrap loader into a core buffer. 

*tC Return to monitor mode. 

..SAVE DSK:COPY^) Save COPY so that the bootstrap loader is preserved 

with the COPY core image. 
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COPY program (Cont) 



Examples (cont) 



.STAKT^) Start the COPY program. 

*DTA5 : /T = J Write the bootstrap loader in blocks 0, 1 , and 2 of 

DTA5. 

TYPE CORE BANK AND OFFSET FOK DTBOOT 

Respond with size of core bank or offset. 

6AKJ Size of core bank (64K core bank = 177000 offset, 

top of core -1000) 

*tC Return to monitor mode. 
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CORE command 



Function 



The CORE command types or modifies the amount of core assigned to the user's job. Because 
programs usually allocate core, the user generally does not need this command. It is included 
for completeness and is used more frequently in non-swapping systems than in swapping systems, 

I If the job is locked into core, this command with a nonzero argument cannot be satisfied and 

therefore gives an erroneous return. 



Command Format 



COREn 



n = a decimal number. This argument is optional . 

If n is omitted, the monitor types out the amount of core used and does not change the 
core assignment. 

If n =0, the low and high segments disappear from the virtual addressing space of the 
job. 

If n >0, n represents the total number of blocks of core to be assigned to the job from 
this point on. 

If n is less than high plus minimum low segment size, n plus high segment size is 
assumed . 

Core arguments can be specified in units of 1024 words or 512 words (a page) by 
following n with the letter K or P, respectively. For example, 3P represents 3 pages 
or 1536 words. If K or P Is not specified, K (1024 words) is assumed. 

On systems with the KA10 processor (DECsystem-1040, 1050, or 1055), 1024 words 
is the minimum unit of allocation and therefore < all arguments are rounded up to the 
nearest multiple of 1024 words. For example, 3P on the KA10 is treated the same as 
2K. 



Characteristics 



The CORE command: 



Leaves the terminal in monitor mode. 

Does not operate when a device is currently transmitting data, 
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CORE command (ConfjJ 



Associated Messages 

Refer to Chapter 4 . 

Examples 



^CORE 5 J * 

..CORE J 

" 5+0/46K CORE 

VIR. CORE LEFT = 274 

..CORE \QPj 
'.CORF 
T0+0/93P CCRE 



VIR. CORE LEFT = 549P 
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CPUNCH command 



Function 

The CPUNCH command is used to place entries into the card punch output queue. This com- 
mand is equivalent to the following form of the QUEUE command: 

QUEUE CDP: job name = list of input specifications 

Command Format 

CPUNCH jobname = list of input specifications 

jobname = name of the job being entered into the queue. The default is the name of 
the first file in the request, not the name of the first file given. These differ when the 
the first file given does not yet exist. 

input specifications = a single file specification or a string of file specifications, sepa- 
rated by commas, for the disk files being processed. A file specification is in the 
form dev:file.ext [proj,prog] . 

dev: = any file structure to which CDPSPL will have access; the default is DSK:. 

file.ext = names of the files. The filename is optional. The default for the first file- 
name is *, the default for subsequent files is the last filename used. The extension 
can be omitted; the default is .CDP. 

[proj,prog] = a directory to which the user has access; the user's directory is assumed 
if none is specified. 

Note that if all arguments to the command are omitted (i.e., only the command name is given), 
the listing of all entries in the card punch queue for all jobs of all users is output. 

The wildcard construction can be used for the input specifications. Switches that aid in con- 
structing the queue entry can also appear as part of the input specifications. These switches 
are divided into three categories: 

1 . Queue-operation - Only one of these switches can be placed in the command 
string because they define the type of queue request. The switch used can appear 
anywhere in the command string. 

2. General - Each switch in this category can appear only once in the command 
string because they affect the entire request. The switch used can appear any- 
where in the command string. 

3. File control - Any number of these switches can appear in the command string 
because they are specific to individual files within the request. The switch used 
must be adjacent to the file to which it applies. If the switch precedes the file- 
name, it becomes the default for subsequent files. 
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CPUNCH command (Cont) 



Command format (cont) 

The following switches can be used with the CPUNCH command. 



Switch 



/AFTER:tt 



/BEFORE :t 

/BEGINrn 
/COPIES:n 

/CREATE 
/DEADLINES 



/DISPOSE:DELETE 



/DISPOSErPRESERVE 



Explanation Category 

Process the request after the specified time; tt is either General 

in the form of hhmm (time of day) or +hhmm (time later 

than the current time). The resulting AFTER time must 

be less then the DEADLINE time. If the switch, or the 

value of the switch, is omitted, no AFTER constraints 

are assumed. 

Queue only the files with a creation date before time 
t where t is in the form dd-mmm-yy hhmm„ If the 
switch, or the value of the switch, is omitted, no 
BEFORE constraints are assumed. 

Start the output on the nth card. The default is to 
begin output on the first card. 

Repeat the output the specified number of times. 
N must be less ihan 64. If more than 63 copies 
are needed, two separate requests must be made. If 
this switch is not specified, the default is 1 . 

Make a new entry into the card punch output queue. 
This switch is the default for the queue-operation 
switches. 

Process the request before the specified time; tt is 
either in the form hhmm (time of day) or +hhmm 
(time later than the current time). The resulting 
DEADLINE time must be greater than the AFTER time. 
If the switch, or the value of the switch, is omit- 
ted, no DEADLINE constraints are assumed. 

Delete the file after spooling. File Control 

Save the file after spooling. This is the default for File Control 

all files except files with extensions .LST, .TMP, 
or .CDP (if protection of .CDP is Oxx). 



General 

File Control 
File Control 

Queue Operation 
General 
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Command Format (cont) 

Switch 
/DISPOSE:RENAME 



/F 

/FORMS:a 
/KILL 



/LIMITrn 
/LIST 



/MODIFY 



Explanation 

Rename the file from the specified directory immedi- 
ately, remove it from the logged-out quota, and 
delete it after spooling. This is the default for files 
with extensions of .LST, .TMP, and, if the protection 
is Oxx, .CDP. 



List the entries in the card punch queue, but do not up- 
date the queues. Therefore, the list may not be an up- 
to-date listing but the listing will be faster than ?il 
/LIST. 



ith 



Place the output on the specified form. The argument 
to the switch must be six alphabetic characters. The 
default is that normal forms are used. 

Remove the specified entry from the card punch queue. 
This switch can be used for deleting a previously- 
submitted request as long as the request has not been 
started by the Spoolers. 

Limit the output to the specified number of cards. 

After updating the queues, list the entries in the card 
punch queue; if this switch, along with all other 
switches, is omitted, all entries for all jobs of all 
users are listed. 

Alter the specified parameters in the job. This switch 
requires that the user have access rights to the job. 
It can be used for altering a previously submitted re- 
quest as long as the request has not been started by the 
Spooler. 



Category 



File Control 



Queue Operation 



General 



Queue Operation 



General 

Queue Operation 



Queue Operation 
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Command format (cont) 



Swi tch 
/NEW 

/NULL 

/OKNONE 
/PHYSICAL 
/PRIORI TY:n 

/PROTECTrnnn 
/PUNCH :026 
/PUNCHrASCII 
/PUNCH rBINARY 
/PUNCH:D029 
/PUNCH: IMAGE 
/REMOVE 



Explanation Category 

Accept the request even if the file does not yet exist. File Control 

An appropriate error message is given if the file does 
not exist by the time the request is processed by the 
spooler. 

Accept the request even if there is nothing in the re- .General 
quest (i.e., create a queue entry to be later modi- 
fied). No error message is given if there are no files 
in the request. 

Do not output message if no files match the wildcard Rle Control 

construction. This is assumed at KJOB time. 

Suppress logical device name assignments for the device File Control 
^specified. 

Assign the specified external priority (n=0 to 62) to the General 
request. The larger the number, the greater priority 
the job has. The default is 10 if no switch is given 
and 20 if the switch is specified without a value. 

Assign the protection nnn (octal) to the fob. If the General 

switch, or the value of the switch, is omitted, the 
standard protection is assumed . 

Punch the files in 026 Hollerith code. If a /PUNCH: File Control 

switch is not given the files are punched according to 
the data mode specified in the file. 

Punch the files in ASCII card code. If a /PUNCH: File Control 

switch is not given, the files are punched according 
to the data mode specified in the file. 

Punch the files in binary card code. If a /PUNCH: Rle Control 

switch is not given, the files are punched according 
to the data mode specified in the file. 

Punch the files in DEC029 card code. If a /PUNCH: Rle Control 

switch is not given, the files are punched according 
to the data mode specified in the file. 

Punch the files in image card code. If a /PUNCH: File Control 

switch is not given, the files are punched according 
to the data mode specified in the file. 

Remove the file from the queue. This switch is valid Rle Control 

only with the /MODIFY and can be used to remove a 
previously submitted file as long as CDPSPL has not 
started processing the request. 
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Command format (cont) 

Switch 
/SEQ:n 

/SINCE:t 

/START:n 

/STRS 

/UNPRESERVED 

Characteristics 



Explanation Category 

Specify a sequence number to help in identifying a re- General 
quest to be modified or deleted. 

Queue only the files with creation dates after the spec i- General 
fied time, t is in the form dd-mmm-yy hhmm. 

Begin on the nth line of the file. If the switch, or the File Control 
value of the switch, is omitted, the spooler starts with 
the first line. 

Search for the file on all file structures in the search File Control 

list and take each occurrence. The default is to take 
just the first occurrence. 

Output the files only if they are not preserved (i.e., General 

the first digit is 0). This switch avoids redundant 

punching. 



The CPUNCH command: 

Leaves the terminal in monitor mode. 

Runs the QUEUE program, thereby destroying the user's core image. 

Depends on FTQCOM which is normally absent in the DECsystem-1040. 

Associated Messages 

Refer to Chapter 4. 

Examples 

•CPJNCH S*bIAT.KAC/PUNCH:ASCI 1} Punch the file SYSTAT.MAC in ASCII format. 



■ CPUNCH SYSTAT.REL/PUNCH:BIIV)ARY/AFTER:1 700^) 



Punch the file SYSTAT.REL in binary format, 
but do not begin punching it until after 5:00 pm. 
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CREATE command 1 



Function 



The CREATE command runs LINED (Line Editor for disk) and opens a new file on disk for 
creation. Refer to the LINED writeup in the DECsystem-10 Software Notebooks. 



Command format 



CREATE file.ext 



file.ext - any legal filename and filename extension. The filename is required; 
the filename extension is optional. 



Characteristics 



The CREATE command: 



Places the terminal in user mode. 

Runs the LINED program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 



Associated Messages 

Refer to Chapter 4. 

Example 

•CRFATF TEST1 »FaJ 



This command runs the COMPIL program , which interprets the commands before running LINED. 
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CREF command 



Function 



The CREF command runs CREF and lists on the line printer (LPT) any cross-reference listing 
files generated by previous COMPILE, LOAD, EXECUTE, and DEBUG commands, using the 
/CREF switch, since the job was initiated. The file containing the names of these CREF- 
listing files is then deleted so that subsequent CREF commands will not list them again. The 
output goes either to LPT immediately or to the disk to be spooled later to LPT. When the 
logical device nams LPT is assigned to a device other than the line printer, the CREF files 
are stored on tha* device with the same filename and the extension .LST. 



Command Format 
CR§F 



Characteristics 



The CREF command: 



Leaves the terminal in monitor mode. 

Runs the CREF program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 



Associated Messages 

Refer to Chapter 4. 



Example 



.COMPILE/CREF#PROMACJ 



,CREF^ 



. LOAD/C/^AH ;[\JAI*iE@CGNALLj 



.ASSIGN KTA1 LHfJ 



Compile the files contained in the command file 
PROMAC and produce CREF input compatible 
cross-reference listing files on the disk. 

Process and list the cross-reference listing files 
produced by the COMPILE command. 

Compile and load the files contained in the 
command file CON ALL. Produce a loader map 
with the filename NAME and CREF input 
compatible cross-reference listing files on the 
di sk . 

Assign the logical name LPT to MTA1 . 

Store the CREF fi les on MTA1 to be listed at a 
later time. 
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CSTART command 
CCONTINUE command 



Function 



The CSTART and CCONTINUE commands are identical to the START and CONTINUE com- 
mands, respectively, except that the terminal is left in the monitor mode. 

Command Format 

CSTART adr 
CCONTINUE 

adr = the address at which execution is to begin if other than the location specified 
within the file (.JBSA). If adr is not specified, the starting address comes from .JBSA. 
An explicit starting address of may be specified for adr. 
To use: 

1 . Begin the program with the terminal in user mode. 

2. Type control information to the program, then type tC to halt the job 
with the terminal in monitor mode. 

3. Type CCONTINUE to allow job to continue running and leave the terminal 
in monitor mode. 

4. Additional monitor commands can now be entered from the terminal. 

Characteristics 

The CSTART and CCONTINUE commands: 

Leave the terminal in monitor mode. 

Require core. 

Depend on FTATTACH which is normally absent in the DECsystem-1040. 

Restrictions 

These commands should not be used when the user program (which is continuing to run) is also 
requesting input from the terminal. These commands are not available to Batch users. 



Associated Messages 

Refer to Chapter 4. 
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CSTART command 
CCONTINUE command 



(Cont) 



Example 



.TYPE L00P.F4J 
*" ACCEPT 10. 1 
10 FORMAT CI) 

DO 20 J»1,I 
20 CONTINUE 

END 

^EXECUTE LOOP^ 

F0RTRANIL0QP.F4 

LOADING 

LOOP 2K CORE 

EXECUTION 

1000000 



tC 
tC 



^CCONTJ 

.TIME,? 
0.95 

KIL0-C0RE"SEC»133 

.TIMEJ 
T.45 

KIL0-CURE-5ECM57 



The user types his source program. 



The user compiles, loads, and executes the program, 



The user indicates that the program should loop 
1000000 times. 

The user stops the program . 

The user continues the program but keeps the term- 
inal in monitor mode. 

The user times the program . 



The program is still running. 



V, 



X SYSTAT 

PLEASE TYPE AC FIRST 

.TIMEJ 

¥.00 

237^7 

KIL0-C0RE-SEC«157 

u. tC 
.C0NTJ 



SYSTAT would cause the program to terminate. 

The program appears to have finished because the 
runtime has stopped incrementing. The program wil 
not output until the CONT command is given. 

Return to the monitor. 

Continue the program so it can complete its typing. 



CPU TIMES5.55 ELAPSED TIME.1.1 :5.73 
NO EXECUTION ERRORS DETECTED 

EXIT 
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D (deposit) command 



Function 



The D command deposits information in the user's core area (high or low segment). When de- 
bugging a sharable program with the D command, the SAVE command should be used rather than 
the SSAVE command (refer to Appendix D). 



Command Format 



D Ih rh adr 



Ih = the octal value to be deposited in the left half of the location. This argument is 
required. 

rh = the octal value to be deposited in the right half of the location. This argument 
is required. 

adr = the address of the location into which the information is to be deposited. This 
argument is optional . 

If adr is omitted, the data is deposited in the location following the last D adr or in 
the location of the last E adr (whichever was last). 



Characteristics 



The D command: 



Leaves the terminal in monitor mode. 
Requires core. 



Associated Messages 



Refer to Chapter 4. 
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D command (Cont) 



Example 



.D 266000 2616 141 



Deposit in location 141 



•E 140 

000140/ 047000 000000 



000140/ 047000 000001 



Exa mine location 140 . 
>D 47000 1 Since adr is omitted, the deposit is in the location 
of the last E command. 

•_ The examine is of the location of 

the previous D command. 
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DAYTIME command 



Function 



The DAYTIME command types the date followed by the time of day. The date and time are 
typed in the following format: 

dd-mmm-yy hh:mm:ss 

where 

dd = clay 

mmm : = month 

yy = year 

hh - hours 

mm = minutes 

ss = seconds to nearest hundredth . 

Command Format 
DAYTIME, 

Characteristics 

The DAYTIME command 

Leaves the terminal in monitor mode. 

Does not require LOGIN. 

Does not destroy the user's core area. 

Example 

.DAY,? 

Tl-SEP-70 22;36:34 

•DAj 

T5-DCC-71 :47:02 
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DCORE command 



FuncHon 



The DCORE command causes the DAEMON program to write a core-image file of the user's 
core area that includes all accumulators and all relevant job tables. The jog can continue to 
run; i.e., the DCORE command does not destroy the user's core area. The file produced may 
be later processed by the DUMP program, if the user so desires. 

The DAEMON-written file consists of four categories: JOB, CONFIGURATION, DDB, and 
CORE. Each category has a two-word header, the first word contains the category number and 
the second word contains the number of data words in the category . The categories are as 
follows: 



Mnemonic 
JOB 
CONFIGURATION 

DDB 

CORE 



Categ ory Number 
1 
2 



Description, 

Job related information. 

The Configuration Table (.GTCNF) from 
theGETTABUUO. 

The device data blocks (DDB) assigned to 
this job. 

The user's core area, both low and high 
segments, in zero-compressed format 
(refer to Appendix D). 



The third word of each category begins the data for that category. DAEMON treats each 
category as a file and the addresses within the category start at zero. The user cannot examine 
the category header nor can he read past the end of one category into the next category . 
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DCORE command (Cont) 



Function (cont) 



The DAEMON-written file appears as follows: 



34 words 



25 words 



N words 



N words 



1 

34 

4 



2 
25 

4 



3 
N 
4 



4 

N 
4 



"1 



n. words of DDB 7 



n„ words of DDB_ 



n words of DDB 



category number 1 

number of octal words that follow 

job related information 

category number 2 

number of octal words that follow 

.GTCNF table 

category number 3 

number of octal words that follow 

N = n, + n_ + . . . + n 
I 2 m 



* Device Data Blocks 



category number 4 

number of octal words that follow 



user's core in zero-compressed format 



Category 1 presently contains the following information, but may expand as more GETTAB 
entries appear. 



Wore! 1 



Version of DAEMON that wrote the file. 

DATE the file was written in standard system format. 

TIME in milliseconds that the file was written. 

JOB NUMBER in left half, HIGH SEG number (or 0) in right half. 



(continued on next page) 
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DCORE command (Cont) 



Function (cont) 



Word 5 



Word 20 



Word 34 



LH is reserved, TTY LINE NUMBER In right half. 

.GTSTS (job status word) for job. 

.GTSTS for high segment. 

.GTPPN (project-programmer number) for job. 

.GTPPN for high segment. 

.GTPRG (user program name) for job. 

.GTPRG for high segment. 

.GTTIM (total time used) for job. 

.GTKCT (kilo-core-ticks) for job. 

.GTPRV (privilege bits) for job. 

.GTSWP (swapping parameters) for job. 

.GTSWP for high segment. 

.GTRCT (disk blocks read) for job. 

.GTWCT (disk blocks written) for job. 

.GTTDB (time of day of last disk allocation, number of disk blocks 

allocated) for job. 
.GTDEV (device or file structure name) for high segment. 
.GTNM1 (first half of user's name) for job. 
.GTNM2 (last half of user's name) for job. 
.GTCMO (charge number) for job. 
.GTTMP (TMPCOR pointers) for job. 
.GTWCH (WATCH bits) for job. 
.GTSPL (spooling control bits) for job. 
• GTRTD (real-time status word) for job. 
.GTLIM (time limit in jiffies) for job. 



Category 2 presently contains the following information, but may expand if more .GTCNF 
entries are added. 



%CNFG0 

%CNFG4 

%CNDT0 

%CNDT1 

%CNTAP 

%CNTIM 

%CNDAT 

%CNSIZ 

%CNOPR 



Name of system in ASCIZ. 



Date of system in ASCIZ. 

Name of system device in SIX BIT, 

Time of day in jiffies. 

Today's date. 

Highest location in monitor +1. 

Name of OPR TTY console. 



(continued on next page) 
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DCORE command (Cont) 



Function (cont) 

%CNDEV LH = beginning of DDB chain. 

%CNSGT LH = - # of high segments, RH = 4* of jobs. 

%CNTWR Non zero if system has two register hardware and software. 

%CNSTS LH = feature switches, RH = current state of switches. 

%CNSER Serial number of processor. 

%CNNSM * of nanoseconds per memory cycle. 

%CNPTY PTY parameters for Batch. 

%CNFRE AOBJN word to use bit map in monitor. 

%CNLOC LH = 0, RH = address of free 4-word core block area. 

%CNSTB Link to STB chain for remote Batch. 

Category 3 contains the device data blocks currently in use for this job. Each DDB is 
preceded by a word containing the length of the DDB. 

Category 4 is a compressed core image of both the high and low segments, i.e., it contains 
only nonzero words. 

Command Format 

DCORE devrname.ext [proj,prog] 

dev: = a disk-like device on which the core-image file is to be written. If omitted, 
DSK is assumed . 

name.ext = the name of the file to be written. The default filename is nnnDAE, 
where nnn is the Job number in decimal, and the default extension is .TMP. If a 
filename is specified, the default extension is .DAE. 

[pro j, prog] = the disk area other than that of the user. If omitted, the user's disk area 
(the number under which he is logged in) is assumed. 

Characteristics 

The DCORE command: 

Leaves the terminal in monitor mode. 

Runs the DAEMON program. 

Can continue after command . 

Depends on FTDAEM which is normally absent in the DECsystem-1040. 
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DCORE command (Cont) 



Associated Messages 

Refer to Chapter 4. 

Examples 

^DCORE^ 

J3C0RE DSKBTFILECJ 



The core image file is written on the user's area of 
the disk with the name nnnDAE.TMP where nnn is 
the user's |ob number. 

The core image file is written in the user's area on 
DSKB with name FILEC.DAE. 
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DDT command 



j 



Function 



The DDT command copies the saved program counter value from .JBPC into .JBOPC and starts 
the program at an alternate entry point specified in JBDDT (beginning address of DDT as set 
by Linking Loader). DDT contains commands to allow the user to start or resume at any desired 
address. Refer to DECsystem-10 Monitor Calls for a description of the job data area locations. 

If the job was executing a UUO when interrupted (i .e. , it was in exec mode and not in TTY 
input wait or SLEEP mode), the monitor sets a status bit (UTRP) and continues the Job at the 
location at which it was interrupted. When the UUO processing is completed, the monitor 
clears the status bit, sets .JBOPC to the address following the UUO, and then traps to the 
DDT address found in JBDDT. If the Job is in exec mode and in TTY input wait or SLEEP 
mode, the trap to the DDT address occurs immediately and .JBOPC contains the address of the 
UUO. If the Job is in user mode, the trap also occurs immediately. Therefore, it is always 
possible to continue the interrupted program after trapping to DDT by executing a JRSTF @ 
.JBOPC. 

For additional information on the DDT program, refer to the DDT Programmer's Referenc e Man- 
ual in the DECsystem-10 Software Notebooks. 



Command Format 
DDT 

Characteristics 



The DDT command: 



Places the terminal in user mode. 

Requires core. 

Requires the user to have a job number. 



Associated Messages 



Refer to Chapter 4. 
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DDT command (Cont) 



Examples 



.TYPE LOOP.MACJ 

loop; jrst loop 

END LOOP 


Type an undebugg< 


.debug loop 
Macro:. main 

LOADING 


Assemble and load 


LOOP 3K CORE 
DDT EXECUTION 




.SAVEJ 

Job saved 


Save the program. 


.START 


Start the program. 


tC 
tC 


Stop it. 


^PDT^ 


Enter DDT. 


LOOP/ JRST LOOP CALLI12 

JRSTF §.JBOPCSX 
EXIT 


Fix the program. 
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DEASSIGN command 



Function 



The DEASSIGN command returns one or more devices currently ASSIGNed to the user's job 
back to the monitor pool of available devices and clears any logical names. Restricted devices 
are returned to the restricted pool, and unrestricted devices to the unrestricted pool. Note 
that an INITed device is not returned to the monitor pool unless a RELEASE UUO is done, 
only the logical name is cleared. Therefore, this command is provided for programs that are 
not termimating or programs that are being debugged. The command, applied to DECtapes, 
clears the copy of the directly currently in core, forcing the next directory reference to 
read a new copy from the tape. (Refer to DECsystem-10 Monitor Colls for further details.) 



Command Format 



DEASSIGN dev 



dev = either the logical or physical device name. This argument is optional . If it is 
not specified, all devices assigned to the user's job, except the job's controlling ter- 
minal, are deassigned, and the iogical name of the controlling terminal is cleared. 



Characteristics 



The DEASSIGN command: 

Leaves the terminal in monitor mode. 



Associated Messages 

Refer to Chapter 4. 

Examples 

_.de:assign lpt:J 

• deassign*) 



The line printer is returned to the monitor's pool 
of available resources. 

All devices assigned to the job are returned. 
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DEBUG command 1 



Function 



The DEBUG command translates the specified source files if necessary (function of the COMPILE 
command), loads the REL files generated (function of the LOAD command), and prepares for de- 
bugging. DDT (the Dynamic Debugging Technique program) is loaded first, followed by the 
user's program with local symbols. Upon completion of loading, control is transferred to the 
DDT program. This program is used to check programs section by section by allowing the user to 
examine and. modify the contents of any location either before execution or during breakpoints. 
Refer to the DDT documentation for a description of the DDT commands. 

Each time a COMPILE, LOAD, EXECUTE, or DEBUG command is executed, the command with 
its arguments is remembered in a temporary file on disk, or in core if the monitor has the 
TMPCOR feature. Therefore, the last filename used can be recalled for the next command 
without specifying the arguments again (refer to Paragraph 1 .5). 

The DEBUG command accepts several command constructions: the @ construction (indirect 
commands), the + construction, the = construction, and the <> construction. Refer to 
Paragraph 1 .5 for a complete description of each of these constructions. 



Command Format 



DEBUG list 



list = a single file specification, or a string of file specifications separated by commas. 
A file specification consists of a device name, a filename with or without an exten- 
sion, and a directory name. 

The following switches can be used to modify the command string. These switches can 
be temporary or permanent (refer to Paragraph 1 .5 .5) . 

/ALGOL Compile the file with ALGOL. Assumed for files with the ex- 

tension of .ALG. 
2 

/BLISS Compile the file with BLISS. Assumed for files with the exten- 

sion of .BLI. 

/COBOL Compile the file with COBOL. Assumed for files with the ex- 

tension of . CBL. 

(continued on next page) 



This command runs the COMPIL program, which interprets the command before running the appro- 
priate processor, the LOADER, and DDT. 

2 . 

BLISS will be recognized as a processor only if the appropriate assembly switch is set. However, 

this assembly switch setting is not supported. 
Version 20 COMPIL 2-51. 
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Command Format (cont) 

/COMPILE 



/CREF 



/FORTRAN 
/FUDGE 



/LIBRARY 



Force a compilation on this file even though a binary file exists 
with a newer date and time than the source file. This switch is 
used to obtain an extra compilation (e.g., in order to obtain a 
listing of the compilation) since normally compilation is not per- 
formed if the binary file is newer than the source file. 

Produce a cross-reference listing file on the disk for each file 
compiled for later processing by the CREF program. These files 
have the filename of the source file and the extension of .CRF. 
The file can then be listed with the CREF command. However, 
with COBOL files, the cross-reference listing is always appended 
to the listing file. No additional command need be given to 
obtain the listing. 

Compile the file with FORTRAN. Assumed for files with the 
extension of .F4 and all files with non-recognizable processor 
extensions (if FORTRAN is the standard processor). 

Create a disk file containing the names of the .REL files pro- 
duced by the command string. When the FUDGE command is 
given, PIP reads this file in order to generate a library REL file. 
Arguments to this switch are: 

/FUDGE:dev:file .ext [proj ,prog] 

dev: - the device on which to write the file. DSK: is assumed. 

file. ext - the name of the library file. The filename is ire- 
quired. If the extension is omitted, it is assumed to be .REL. 

[proj, prog] - the directory in which to place the file. The 
user's directory is assumed if none is given. 

This switch is permanent in the sense that it pertains to all REL 
files generated by the command string. 

Load the files in library search mode. This mode causes a pro- 
gram file in a special library file to be loaded only if one or 
more of its declared entry symbols satisfies an undefined global 
request in the source file. The system libraries are always 
searched. Refer to the LOADER documentation. 



(continued on next page) 
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DEBUG command (Cont) 



Command format (cont) 
/LIST 



/LMAP 

/MACRO 

/MAP 



/MACX11 1 
/NOCOMPILE 



/NOLIST 
/NO SEARCH 



Generate a disk listing file, for each file compiled, with the 
filename of the source file and the extension.LST. These files 
can be listed later with the LIST command. Unless this switch is 
specified, listing files are not generated except in COBOL; 
COBOL listings are always generated. 

Produce a loader map during the loading process (same action 
as /MAP) containing the local symbols. 

Assemble the file with MACRO. Assumed for files with exten- 
sions of .MAC. 

Produce a loader map during the loading process. When this 
switch is encountered, a loader map is requested from the 
loader. After the library search of the system libraries, the 
map is written in the user's disk area with either the filename 
specified by the user (e.g., /MAP:file)or the default filename 
MAP. MAP. This switch is an exception to the permanent 
switch rule in that it causes only one map to be produced 
even though it may appear as a permanent switch. 

Assemble the file with MACXIl . Assumed for files with the 
extension . PIT . 

Complement the /COMPILE switch by not forcing a compilation 
on a source file whose date is not as recent as the date on the 
binary file. Note that this switch is not the same as the /R EL 
switch, which turns off all compilation, even if the source file 
is newer than the REL file. /NOCOMPILE is the default 
action . 

Do not generate listing files. This is the default action except 
for COBOL files; COBOL listings are always generated. 

Loads all routines of the file whether the routines are referenced 
or not. Since this is the default action, this switch is used 
only to turn off library search mode (/LIBRARY). This switch is 
not equivalent to the /P switch of the LOADER, which does not 
search any libraries. The /NOSEARCH default is to search the 
system libraries. 



(continued on next page) 



MACXIl (the PDP-11 assembler for the PDP-10) will be recognized as a processor only if the appro- 
priate assembly switch is set. However, this assembly switch setting is not supported. 
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Command format (cont) 
/REL 

/SNOBOL 



Use the existing REL files although newer source files may be 
present. 

Compile the file with SNOBOL. Assumed for files with exten- 
sions of .SNO. 



Characteristics 



The DEBUG command: 

Places the terminal in user mode. 

Runs the appropriate processor, the LOADER, and DDT. 

Associated Messages 

Refer to Chapter 4. 

Examples 

^.DEBUG/L FILEA#FILEB#FILEC/N#FILEDJ Generate listings for FILEA, FILEB, and 

FILED 



..DEBUG TEST \ 
MACRO: TES T 
LOADING 



LOADER 2K COKE 
DDT EXECUTION 



./ 



BLT 15,0C16) 



SNOBOL will be recognized as a processor only if the appropriate assembly switch is set. However, 
this assembly switch setting is not supported. 
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DELETE command 1 



Function 



The DELETE command deletes one or more files from disk or DEOape. 



Command Format » 
DELETE list 



list = a single file specification or a string of file specifications separated by commas, 
The full wildcard construction (* and ?) can be used. 

If a device or file structure name is specified, it remains in effect until changed or 
until the end of command string is reached. 



Characteristics 

The DELETE command: 

Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 

Associated Messages 

Refer to Chapter 4. 

Examples 

^DEL *.MAC^ 

FILES DELETED ; 

Tl «MAC 

T2 . MAC 

T3 . MAC 

14 BLOCKS FREED 

^DEL TEST1 .MAC J 
FILES DELETED : 
TEST1 .MAC 
3 RLOCKS FREED 



In • 



This command runs the COMPIL program, which interprets the command before running PIP. 



Version 20 COMPIL 

Version 32 PIP 2 " 55 
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Examples (cont) 



.DEL TEST??.F4J 
FSLES DELETEDt 
TEST.F4 
TESTS. F4 
TE8T03.F4 
TESTZ.F4 

23 BLOCKS FREED 



Version 20 COMPIL 2-56 

Version 32 PIP 
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DETACH command 



Function 



The DETACH command disconnects the terminal from the user's job without affecting the status 
of the job. The user terminal is now free to control another job, either by initiating a new 
job or attaching to a currently running detached job. 



Command Format 
DETACH 

Characteristics 



The DETACH command: 



Detaches the terminal . 

Depends on FTATTACH which is normally absent in the DECsystem-1040. 



Restrictions 



This command is not available to Batch users. 

Associated Messages 

Refer to Chapter 4. 



Example 



.DETACH j? 
FROM JOB 1 
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DIRECT command 



Function 



The DIRECT command lists the directory entries specified by the argument list. The standard 
output consists of the following columns: filename, filename extension, length in blocks 
written, protection, creation date, version number, structure name, and directory name. 



Command Format 



DIRECT output specification = list of input specifications 

list = A single file specification, or a string of files specifications separated by commas or 
plus signs. The devices used on input can be DSK:, DTA:, MTA:, and TMP: (TMPCOR). If 
the device is a magnetic tape, the tape is rewound before and after the listing operation and 
analyzed to determine if it is a FAILSAFE or BACKUP tape. The default input specification 
is DSK:*.*, and the user's directories in all file structures defined by the job's search list are 
listed. Generally, a device name, an extension, or a directory name that precedes the file- 
name becomes the default for all succeeding fules in the list. The full wildcard construction 
can be used. 



output specification = This argument (and the equal sign) is optional. If the entire output 
specification is omitted, the default is TTY:. If an output filename is given, the default de- 
vice is DSK:. If an output filename is not given, and one is needed, the filename is generated 
from the time of day as hhmmss. The default output extension is .DIR. The wildcard con- 
struction cannot be used in the output specification. 

The following switches may be used in the command string. Switches that precede the file- 
name become the default for all succeeding files. Switches can be abbreviated as long as the 
abbreviation is unique. 



/ACCESS:n 



/ALLOC 



Update; the access date to the current date for any file of n blocks 
or less accessed by the DIRECT program, n is the written length 
unless the ALLOC switch is used and is a decimal number. If 
/ACCESS is omitted, the date is not changed. If /ACCESS is 
specified but :n is omitted, n=5 is assumed. 

List the allocated length of the file instead of the written length. 
The allocated length is used by LOGOUT in checking quotas. 
(Disk and magnetic tape only.) 



(continued on next page) 
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Command Format (cont) 
/CHECKSUM 

/DENSITY :n 
/DETAIL 

/FAST 

/HELP 

/HELP:S 

/LIST 

/MARKS 

/OKNONE 

/PARITY :ODD 
/PARITY: EVEN 

/PHYSICAL 

/PROTECTION:nnn 

/RUNrfile spec 

/RUNOFFSETrn 

/SLOW 



Compute and print an 18-bit checksum for each file. This check- 
sum is computed by rotating the result left one bit before adding 
each word. (Disk and magnetic tape only.) 

Use the specified density when reading a magnetic tape. N is 
200, 556, or 800 bpi„ The default is installation dependent 
and is modified by the SET DENSITY command. 

Print all nonzero words in the LOOKUP block. The protection and 
data mode are also listed, even if they are zero. The author is not 
listed if it is the same as the owner of the directory. (Disk and 
magnetic tape only.) 

List short form of directory (i.e., filename, extension, structure 
name, and directory name). Equivalent to /F. 

Help text which indicates some of the switches available and how 
to use them. Equivalent to /H. 

List all switches (S) without their explanations. An asterisk pre- 
fixes those switches which have a single-letter abbreviation. 

List the output on device LPT:. Equivalent to /L. 

Indicate each tape mark and UFD when reading a magnetic tape. 

Suppress the error message if no files match the wildcard construc- 
tion „ 

Specify the parity to be used when reading a magnetic tape. The 
default is ODD. 

Ignore logical names used for device names. 

Give the output file the protection nnn (octal). 

Run the specified program when this command is finished. 

Run the program specified with /RUN with an offset of n . If the 
switch is omitted, the default is 0; if the switch is given without a 
value, the default is 1 . 

Output a full listing that includes the filename, extension, length 
in blocks written, protection, creation time, access date, structure 
name, and directory name. Equivalent to /S. (Disk and magnetic 
tape only.) 

(continued on next page) 
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Command Format- (cont) 
/SORT 

/SUMMARY 

/TITLES 

/UNITS 

/'Width m 
/Words 

Characteristics 

The DIRECT command: 



List the file structure name and directory name on each line instead 
of only on the first line in which they change. Multiple spaces 
are output instead of TABs. This switch is used to prepare a file to 
be sorted by the SORT program. 

Output only the summary line which indicates the total number of 
blocks and files. Note a /F /SUMMARY lists a /F listing Followed 
by the summary . 

Cause a heading to be output on each page consisting of a label 
for each column, date, time, and page number. Standard output 
to the line printer has this heading. 

List the name of the actual disk unit instead of the file structure 
name. 

Output several entries on a single line to make the output n col- 
umns wide. For example, if /F is specified for output to the scope, 
four filenames appear per line. The default for n is 64 columns. 

Output the length of the file in words instead of blocks. 



Leaves the terminal in monitor mode. 

Runs the DIRECT program,, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 



Examples 



.OIK DTA3:J 
_._DIR *.NiACj 

JL DIK TFST.F4C27,603^ 



Lists all files on DTA3. 

Lists all files with MAC filename extension in all 
file structures in the job search list. 

Lists the directory entry for file TEST.F4 in user 
area 27, 60. 

(continued on next page) 
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Examples (cont) 

^DIRECT^ 

SAMPL CTL 1 <155> 4-MAY-71 

PIP DAE «055> 25-FEB-72 

G16DAE TMP 22 <055> 25-FEB-72 

WEIRD 4 «055> 25-FEB-72 

WEIRD SAV 21 <055> 25-FEB-72 



DSKC! 



34(70) 



t27,235) 



TOTAL OF 48 BLOCKS IN 5 FILES ON OSKCI (27,2351 



.DIRECT/ALLOC 








SAMPL CTL 


3 


<155> 


4-MAY-71 


PIP DAE 


2 


<055> 


25-FEB-72 


G16DAE TMP 


24 


<055> 


25-FEB^72 


WEIRD 


6 


<055» 


25-FEB-72 


WEIRD SAV 


23 


<055> 


25-FEB-72 



DSKCI 



34(70) 



[27,235) 



TOTAL OF 58 BLOCKS IN 5 FILES ON DSKC! (27,233) 



^DIRECT/DETAIL^ 

DSKC0! SAMPL. CTL (27,235) 

ACCESS DATE: 5-JAN-72 

CREATION TIME, DATE! 16:51 4-MAY-71 

ACCESS PROTECTION! 155 

MODE* 14 

WORDS WRITTEN! 54. 

ESTIMATED LENGTH: 5. 

BLOCKS ALLOCATED! 3. 

DATA BLOCK IN DIRECTORY: 303. 

DSKC0:pIP.DAE[27,235J 

ACCESS DATE: 25-FEB-72 

CREATION TIME, DATE! 13!47 25-FEB-72 

ACCESS PROTECTION! 055 

MODE! 17 

BLOCKS ALLOCATED: 2. 

AUTHOR " 1 2 

DATA BLOCK IN DIRECTORY! 303. 



(continued on next page) 
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DIRECT command (Cont) 



Examples (cont) 



DSKC0JG16DAE.TMP [27,235] 

ACCESS DATE! 25-FEB-72 

CREATION TIME, DATE: 14:10 25-FEB-72 

ACCESS PROTECTION: 055 

MODE: 17 

WORDS WRITTEN: 2816. 

BLOCKS ALLOCATED: 24. 

AUTHORM. 2 

DATA BLOCK IN DIRECTORY: 303. 

DSKC0J.WEIRO. [27,235] 

ACCESS DATE: 25-FEB-72 

CREATION TIME, DATE: 14:38 25-FEB-7? 

ACCESS PROTECTION: 055 

MODE: 1 

WORDS WRITTEN: 471. 

BLOCKS ALLOCATED: 6. 

DATA BLOCK IN DIRECTORY: 303. 

DSKC0 » WEIRD. SAV [27,235] 

ACCESS DATE: 25-FEB-72 

CREATION TIME, DATE: 14:09 25-FEB-72 

ACCESS PROTECTION: 055 

MODE: 10 

WORDS WRITTEN: 2566, 

VERSION:34C70) 

BLOCKS ALLOCATED: 23. 

DATA BLOCK IN DIRECTORY: 303. 



TOTAL OF 48 BLOCKS IN !5 FILES ON DSKC: [27#235] 

■ DIRECT [40, *]J Lists *^ e directory entries for user with project 

~ number 40 and the user's programmer number. 
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DISMOUNT command 



Function 



The DISMOUNT command allows a user to return devices to the monitor pool of available re- 
sources and to remove a file structure from his search list. Restricted devices are returned to 
the restricted pool and unrestricted devices to the unrestricted pool. The command applied to 
non-file structures is identical to the DEASSIGN command if the user waits for completion of 
the operator action. If the user does not wait for completion (e.g. , he types a control-C 
after the message OPERATOR NOTIFIED), the device is not deassigned, but the request to the 
operator is still queued for the purpose of removing the media. The user must then issue the 
DEASSIGN command to release the device. This command applied to file structures enforces 
logged-out quotas (if necessary), allows physical removal of disk packs (if there are no other 
users of the pack), and removes the file structure name from the job l s search list. 

The UMOUNT program runs privileged in the user's core area when the DISMOUNT command 
is typed. This program scans the user's command string, checks its validity, and performs as 
much of the requested action as possible. The UMOUNT program can complete all actions 
requested by the DISMOUNT command except for the action of physically removing packs, 
tapes, or cards. When operator action is required, the UMOUNT program writes a command 
file on 3,3 disk area and notifies the OMOUNT program (running on the operator's terminal) 
to perform the action. When the operator action has been completed, OMOUNT deletes the 
command file and notifies UMOUNT (if UMOUNT is waiting) to inform the user of completion 



Command Format 



DISMOUNT dev: switches 

dev: = any previously ASSIGNed or MOUNTed device or file structure name. This 
argument is required . 

switches = the following switches are optional and only enough characters to make the 
switch unique are required. 

/CHECK Check and list pending requests. 

/HELP Type this list. 

/PAUSE Notify the user before requesting operator action. The user can 

then abort the command if desired. 

(continued on next page) 
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DISMOUNT command (Cont) 



Command Format (cont) 

/REMOVE 



Notify operator to physically remove disk packs, tape, or cards. 
A file structure is removed from the system only if no other users 
are using it. A request to remove the pack is queued to the opera- 
tor and the message WAITING ... is typed to the user. If the 
user does not want to wait for confirmation of the operator action, 
he may type control-C. This switch must be specified to notify the 
operator to remove the pack, even if no other jobs are using it. 



Characteristics 

The DISMOUNT command: 

Places the terminal in user mode. 

Runs the UMOUNT program, thereby destroying the user's core image. 

Depends on FTCCLX and FTMOUN which are normally absent in the DEGystem-1040. 

Associated Messages 

Refer to Chapter 4. 



Examples 



^DISMOUNT DSKA:^- 
DSKA DISMOUNTED 

iDISMOUNT DTA4:/R^ 
OPERATOR NOTIFIED 

WAITING... 



tC 

JHSMOUNT/CHECK^ 
NONE PENDING 
O.COHHANDS X"n QUEUE 



The user dismounts the file structure DSKA. This 
does not require an operator action . 

The user asks the operator to deassign DTA4 and 
remove the tape. 

The command is waiting for completion of the 
operator action . 

The user does not wish to wait for confirmation of 
removal . 

The user checks for completion and determines that 
his request is finished . 
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DSK command | 



Function 



The DSK command types disk usage for the combined structures of the job since the last DSK 
command, followed by the total disk usage since the job was init.ahzed (logged ,n). D-sk 
usage is typed in the following format: 



RD,WT=I,J 
RD,WT=M,N 



where I and J are the incremental number of 128-word blocks read and written since the last 
DSK ^ command, and M and N are the total number of 128-word blocks read and wntten s.nce 
the job was initialized. 

NOTE 

I and J are kept modulo 4096. If automatic READ or 

WRITE print outs have been enabled using the SET 

WATCH command, I and J are usually zero, since the 

SET WATCH output also resets these values. 

C ommand Format 

DSK job 

job = the job number of the job for which the disk usage is desired . This argument is 

optional . 

If job is omitted , the job to which theterminal is attached is assumed . 

If job is supplied (whether the Job of this user or another user) the incremental quantities 
are not reset to zero , 

Characteristics 

The DSK command: 

Leaves the terminal in monitor mode. 

Asso ciated Messages 

Refer to Chapter 4. 
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DSK command (Cont) 



Example 



..DSK J 
RD,WT = 12,I 



RD,WT=475,243 
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DUMP command 



Function 



The DUMP command calls the DAEMON program to write a core image file (function of the 
DCORE command) and then invokes the DUMP program to analyze the file written and to pro- 
vide printable output. The core image file is named nnnDAE.TMP where nnn is the user's Job 
number. This file is described in detail in the DCORE command description. 



Command Formats 



1 . DUMP /command /command /command . . . 

2. DUMP @ dev:file.ext Tpro^prog] 

3. DUMP 

The commands that appear in the DUMP command string are passed to the DUMP program and 
therefore are described in the DUMP program description. A DUMP command using a command 
file can also specify these commands. A DUMP command without any arguments prints a short 
dump of the user's core area via the command file QUIKDM.CCL which resides on device SYS: 



Characteristics 



The DUMP command: 



Leaves the terminal in monitor mode. 

Runs the DAEMON program. 

Depends on FTDAEM which is normally absent in the DECsy stem- 1040. 

Associated Messages 

Refer to Chapter 4. 

Examples 

.DUMP /OUT : TT Y : /MODE: ASCII. S I XB IT /WIDTH S7, 10/ JUST H,P-J 
7RIGHTMAS26/DC3000 & 30Q4 

This command string writes a core image file named nnnDAE.TMP and invokes the 
DUMP program to perform the output. The output goes to the terminal and the modes 
used on output are ASCII and SIXBIT. The ASCII field is 7 characters long, left justi- 
fied and the SIXBIT field is 10 characters long, right justified. The right margin of the 
output in 26 characters. The dump consists of the contents of word 3000 to word 3004. 
The hyphen is used to continue the command string onto the next line. 
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DUMP program 



Function 



The DUMP program provides printable dumps of arbitrary data files in modes and forms specified 
by the user. The DUMP program accepts any data file as input and produces an ASCII file 
suitable for listing by PIP, the output spoolers, or other listing programs. For example, the 
DUMP program takes core image files prepared by the DAEMON program or SAVEd files pro- 
duced by the monitor. For a description of the DAEMON -written file, refer to the DCORE 
command . 



Command Formats 



1. 



R DUMPJ> 
/command^) 



2. R DUMP^ 

/@ dev:file.ext [proj,prog] 



NOTE 
DUMP indicates its readiness by typing a slash {/) instead 
of an asterisk. 

The commands with their arguments are as follows. Lines can be continued by typing a hyphen 
followed by a carriage rerurn. 

Meaning 

Specifies if the address is to be dumped along with 
its contents. The default is ON. 

Dumps the entire file. If the file is a DAEMON 
core image file, the entire category is dumped. 

Appends the output to the output file. The existing 
output file is not overwritten. This command is the 
default; its complement is SUPERSEDE. 

Attempts to format output with line feeds, form 
feeds, and titles, if ON. If OFF, the user is 
responsible for all formatting. The default is ON. 

Selects the category of the DAEMON dump file to 
be used. Addressing begins with at the beginning 
of each category. The default category is CORE. 
If the input file is not a DAEMON file, this switch 
has no effect . 

(continued on next page) 



Command 


Argument 


ADDRESS 


ON or OFF 


ALL 




APPEND 




AUTOFORMAT 


ON or OFF 


CATEGORY 


mnemonic for name of 
category. Can be JOB, 
CONFIGURATION, 
DDB, or CORE. 
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DUMP program (Cont) 



Command formats (cont) 

Command Argument 

CLOSE 



DUMP 

EJECT 
EXIT 

INPUT 



dump descriptor, 
dump descriptor, , 



<file descriptor > 



I RADIX 



decimal number 



JUSTIFY 



LEFT, CENTER, or 
RIGHT 



LEFTMARGIN expression 

LINEPAGE expression 



Meaning 

Closes the output file. After this command is given, 
another OUT command should be given before the 
next command which does any output. 

Dumps the specified bytes in the current modes. 



Starts a new page in the output file. 

Closes all tiles and returns control to the monitor 
(tZ has the same effect;. 

Specifies the input file. The defaults are: 
DSK:nnnDAE.TMP where nnn is the job number; the 
user's directory. If the filename is specified, it 
determines the extension from the set .TMP, .DAE, 
.SHR, .SAV, .HGH, .LOW, .XPN, and .DMP in 
that order. If an extension is specified with no 
filename, the extension determines the filename. 

Specifies radix for numbers for input. This com- 
mand uses decimal to compute the argument. The 
default is 10 for decimal. The argument must be 
numeric. If numeral is or. is missing, the input 
radix is set back to its default value. 

Specifies the justification of the output in the out- 
put field. If the output overflows the output field, 
the entire output appears; it is not truncated. This 
switch is used in a one-to-one relationship with the 
MODE and WIDTH commands. If there are more 
MODE commands, an argument of LEFT is used. If 
there are more JUSTIFY commands, they are 
ignored . 

Sets the left margin of the output file. The default 
is 0. 

Specifies the number of lines per output page. The 
default is 50. 



(continued on next page) 
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DUMP program (Cont) 



Command Formats (cont) 



Command 



Argument 



MODES 



ASCII, DECIMAL, NULL, 
NUMERIC, OCTAL, 
RADIX50, SIX BIT, 
SOCTAL, or SYMBOLIC. 



NUMPAGE 



ORADIX 



OUTPUT 



expressi on 



decimal number 



<flle descriptor> 



RIGHTMARGIN expression 



SUPERSEDE 



Meaning 

Selects the type of output. ASCII dumps the word 
as a single right justified character if bits 0-28 are 
zero or as 5 ASCII characters if bits 0-28 are non- 
zero. Non printing characters print as a space. 
DECIMAL dumps as a signed decimal number. NULL 
declares that nothing is to be dumped. NUMERIC 
dumps as a signed number in the current output radix. 
OCTAL dumps as half-words separated by a comma 
(default) and takes 13 positions. RADIX50 dumps 
in RADIX50. SIXBIT dumps as one SIXBIT character 
if bits 0-24 are zero, or 6 SIXBIT characters if 
bits 0-24 are nonzero. SOCTAL dumps as signed 
octal and suppresses leading zeroes. SYMBOLIC 
dumps as a symbolic instruction. 

Any mode specification can appear more than once 
in the command string. The output is in the same 
order as the MODE list. 

Specifies that pages are to be numbered. If expres- 
sion is 0, page numbering is turned off. If expres- 
sion is not 0, page numbering begins at page = 
<expression>. If command is omitted, numbering 
starts at the first page. 

Specifies radix for numbers for output. The default 
is TO for decimal . If number is 0, the standard is 
used. The argument to this command is decimal 
and must not be an expression. 

Specifies the output file. The defaults are: LPT:, 
the filename of the input file; the extension . LSD; 
the user's directory. 

Sets the right margin of the output file. A field 
may overflow the right margin if it will not fit be- 
tween the left and right margins. If ADDRESS is ON, 
the new line will have an address typed. If a page 
overflow occurs, a title line may also be printed. 

Specifies that the output is to supersede an existing 
file of the same name, if there is one. The comple- 
ment of this command is APPEND, which is the 
default. 



(continued on next page) 
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DUMP program (Cont) 



Command Formats (cont) 

Command Argument 

SYFILE < f '' e descriptor > 



TDUMP 



TITLE 



dump descriptor, 
dump descriptor,... 

<string of characters > 



TYPE 1 


DAE 


TYPE 


DAT 


TYPE 


HGH 


TYPE 


LOW 


TYPE 


SAV 


TYPE 


SHR 


TYPE 


XPN 


WIDTH 


expression 



XTRACT 



Meaning 

Specifies the file to take symbols from if XTRACT 
command is specified. Defaults are: DSK:, the 
filename of the input file; one of the saved file 
extensions; the user's directory area. 
Dumps specified bytes to both output file and TTY. 

Specifies a title to be included in the subsequent 
page headings. If no argument is specified, titling 
is turned off. 

After this command, an EJECT command should be 
given to skip to a new page. 

Specifies that the input file is separated by 

DAEMON. 

Specifies that the input file is a data file (i.e., no 

special format; therefore, no special processing is 

done) . 

Specifies that the input file is in .HGH file format. 

Specifies that the input file is in .LOW file format. 

Specifies that the input file is in .SAV file format. 

Specifies that the input file is in .SHR file format. 

Specifies that the input file is in .XPN file format. 

Selects the width of each output mode (see the 
MODE and JUSTIFY commands). If a MODE com- 
mand is specified without a corresponding WIDTH, 
the byte is dumped in exactly the number of posi- 
tions required followed by 3 blanks. If a WIDTH 
command is specified, no free blanks are output. ^ 
If a MODE specification overflows its WIDTH speci- 
fication, the entire output is given without justifi- 
cation. If expression is omitted, a null list will be 
generated .^ 

Uses the file specified in the last SYFILE command 
as a core image and extracts the symbol table. 



1 lf TYPE is not specified, the extension of the input file ^^^^^ t^T^ 
produced. If the extension is not one recogn.zed in -the TYPE command, 
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DUMP program (Contj ] 

Command Formats (cont) 

An ? p^ , , a ^ hmeMc operafions 

I. o string of S1XUT charTctZ, rZ~Zrt S ^"'^ «' V "" @) - A ^ mb °' 
taining symbol . ' P 9 SymM ' where P 1 ^™ 1 " ^"nes the program con- 

fen^^.^^^ltZ^r'T 11 '" *!*\«»*~ S P«>°' Meters ore rev- 
indicates that £ZZtZ£%??L a^T*— 1^'°' ^"' ° double <■«"• 
special pattern. The follow!™ oatl=r»„rl P ! "' ' S ' "I?""? '"^'"^ " ° s P art ° f <■ 
ootpot strings by the charaZ* gZZXS. H3K tt ^ ^ " "•"— '" 

<EL> - end line, <CR-I_F> 

<VT> - vertical tab 

<FF> - f orm f eec j 

<AL> - altmode 

<HT> - horizontal tab 

t <letter> - control character 

\ <letter> - lower case character 

A Me^criptor Is the description of the byte in the input file to be damped. Tbe format is: 

WORDS <POS, SIZE> 
where 

WORDS = the address of the word desired. 

m°st hi*; z'l;::! ,he Me wifhin ,he word - » *•"*"- *• *> ■»»*. of *e .*. 

£and = ari h e:. nUmber " "" '" *' b "" " *» be °^ -» «* can crass word or block 
A c lump descrip tor has the form 

<FROM byte-descriptor>& <TO byte descriptor > 
signifying everything from the first byte descriptor to the second. 
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DUMP program (Cont) 



Characteristics 



The R DUMP command: 



Places the terminal in user mode, 
Is used with disk monitors only. 
Runs the DUMP program. 



Associated Messages 

Refer to Chapter 4. 
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E (examine) command 



Function 

The E command examines a core location in the user's area (high or low segment). 

Command Format 



E adr 



adr is required the first time the E or D command is used. If adr is specified, the con- 
tents of the location are t/ped out in half-word octal mode. 

If adr is not specified, the contents of the location following the previously specified 
E adr or the location of the previous D adr (whichever was last) are typed out,, 



Characteristics 



The E command: 

Leaves the terminal in monitor mode. 
Requires core . 

Associated Messages 

Refer to Chapter 4. 

Example 

• E \A?)J 

000140/ 264000 002616 »E 

000141/ 000000 000000 ~E 

000142/ 000000 000000 ~. 
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EDIT command 1 



Function 



The EDIT command runs LINED (Line Editor for disk) and opens an already existing line 
sequence-numbered file on disk for editing. Refer to the LINED writeup in the DECsystem-10 
Software Notebooks. 



Command format 



EDIT file.ext 



file.ext = a filename and filename extension of an existing file. This argument is op- 
tional if a CREATE or EDIT command has been given since the initialization of the job, 
because the arguments of the EDIT-class commands are remembered in temporary files 
on the disk or in core if the monitor has the TMPCOR feature. 



Characteristics 



The EDIT command: 



Places the terminal in user mode. 

Runs the LINED program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 



Associated Message s 

Refer to Chapter 4 . 

Example 

^EDIT TEST.F4J 
* 



This command runs the COMPIL program, which interprets the command before running LINED. 

Version 20 COMPIL 
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EOF command 1 



Function 

The EOF command writes an end of file mark on the specified magnetic tape. This command is 
equivalent to the following PIP command string: 

MTAn: (MF) - 

Command Format 

EOF MTAn: 

Characteristics 

The EOF command: 

Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 

Associated Messages 

Refer to Chapter 4. 

Examples 

.EOF K-TA3:^ 



This command runs the COMPIL program, which interprets the command before running the PIP program, 
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EXECUTE command 1 



Function 



The EXECUTE command translates the specific source files if necessary (function of COMPILE 
command), loads the REL files generated into a core image (function of LOAD command), and 
begins execution of the program. The assembler or compiler used is determined from the 
source file extensions or from switches in the command string (refer to the COMPILE command). 
If a REL file already exists with a newer date than that of the source file, compilation is not 
performed (unless requested explicitly via a switch). 

This command is equivalent to a LOAD and START sequence of commands. 

Each time a COMPILE, LOAD, EXECUTE, or DEBUG command is executed, the command with 
its arguments is remembered in a temporary file on disk, or in core if the monitor has the 
TMPCOR feature. Therefore, the last filename used can be recalled for the next command 
without specifying the arguments again (refer to Paragraph 1 .5). 

The EXECUTE command accepts several command constructions: the @ construction (indirect 
commands), the + construction, the = construction, and the < > construction . Refer to Para- 
graph 1 .5 for a complete description of each of these constructions. 



Command Format 



EXECUTE list 



list = a single file specification, or a string of file specifications separated by commas. 
A file specification consists of a device name, a filename with or without an extension, 
and a directory name. 

The following switches can be used to modify the command string. These switches can 
be temporary or permanent switches (refer to Paragraph 1 .5.5). 

/ALGOL Compile the file with ALGOL. Assumed for files with the exten- 

sion of .ALG. 
2 

/BLISS Compile the file with BLISS. Assumed for files with the extension 

of .BLI. 

/COBOL Compile the file with COBOL. Assumed for files with the exten- 

sion of . CBL . 



(continued on next page) 



This command runs the COMPIL program, which interprets the command before running the appropriate 
processor and the LOADER. 

2 
BLISS will be recognized as a processor only if the appropriate assembly switch is set. However, this 

assembly switch setting is not supported. 
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EXECUTE command (Cont) 



Command Format (cont) 
/COMPILE 



/CREF 



/FORTRAN 
/FUDGE 



/LIBRARY 



/LIST 



Force a compilation on this file even though a binary file exists 
with a newer date and time than the source file. This switch is 
used to obtain an extra compilation (e.g., in order to obtain a 
listing of the compilation) since normally compilation is not per- 
formed if the binary file is newer than the source file. 

Produce a cross-reference listing file on the disk for each File 
compiled for later processing by the CREF program. These files 
have the filename of the source file and the extension of .CRF. 
The files can then be listed with the CREF command. However, 
with COBOL files, the cross-referenced listing is appended to 
the listing file. No additional command need be given to obtain 
the listing. 

Compile the file with FORTRAN. Assumed for files with the ex- 
tension of .F4 and all files with nonrecognizable processor exten- 
sions (if FORTRAN is the standard processor). 

Create a disk file containing the names of the .REL files produced 
by the command string. When the FUDGE command is given, PIP 
reads this file in order to generate a library REL file. Arguments to 
this switch are: 

/FUDGE :devrfile.ext[proj, prog] 

dev: - the device on which to write the file. DSK: is assumed. 

^file.ext - the name of the library file. The filename is required. 
If the extension is omitted, it is assumed to be .REL. 

[proj,prog] - the directory in which to place the file. The user's 
directory is assumed if none is given. 

This switch is permanent in the sense that it pertains to all REL files 
generated by the command string. 

Load the files in library search mode. This mode causes a program 
file in a special library file to be loaded only if one or more of its 
declared entry symbols satisfies an undefined global request in the 
source file. The system libraries are always searched. Refer to 
the LOADER documentation. 

Generate a disk listing file, for each file compiled, with the 
filename of the source file and the extension of . LST. These 
files can be listed later with the LIST command. Unless this 
switch is specified, listing files are not generated except in 
COBOL; COBOL listings are always generated. 

(continued on next page) 
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EXECUTE command (Cont) 



Command Format (cont) 
/LMAP 

/MACRO . 



/MACX11 
/MAP 



/NOCOMPILE 

/NOLIST 
/NOSEARCH 

/REL 
/SNOBOL 2 



Produce a loader map during the loading process (same action as 
/MAP) containing the local symbols. 

Assemble the file with MACRO. Assumed for files with extensions 
of .MAC. 

Assemble the file with MACX11 . Assumed for files with extensions 
of .Pll. 

Produce loader maps during the loading process. When this switch 
is encountered, a loader map is requested from the loader. After 
the library search of the system libraries, the map is written in the 
user's disk area with either the filename specified by the user 
(e.g., /MAPrfile) or the default filename MAP. MAP. This switch 
is an exception to the permanent switch rule in that it causes only 
one map to be produced even though it appears as a permanent 
switch . 

Complement the /COMPILE switch by not forcing a compilation on 
a source file whose date is not as recent as the date on the binary 
file. Note that this switch is not the same as the /REL switch, 
which turns off all compilation, even if the source file is newer 
than the REL file. /NOCOMPILE is the default action. 

Do not generate listing files. This is the default action except for 
COBOL files; COBOL listings are always generated. 

Loads all routines of the file whether the routines are referenced or 
not. Since this is the default action, this switch is used only to 
turn off library search mode (/LIBRARY). This is not equivalent to 
the /P LOADER switch, which does not search any libraries; the 
/NOSEARCH switch scans the system libraries. 

Use the existing REL files although newer source files may be 
present . 

Compile the file with SNOBOL. Assumed for files with an exten- 
sion of .SNO. 



MACX11, the PDP-11 assembler for the PDP-10, will be recognized as a processor only if the appro- 
priate assembly switch is set. However, this assembly switch setting is not supported. 

"SNOBOL will be recognized as a processor only if the appropriate assembly switch is set. However, 
this assembly switch setting is not supported. 
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Characteristics 

The EXECUTE command: 

Places the terminal in user mode. 

Runs the appropriate processor and the LOADER. 

Starts the execution of the compiled and loaded program, 

Associated Messages 

Refer to Chapter 4. 

Examples 

^EA-ECUTE TEST*) 
MACRO: TEST 
LOADING 

LOADEH 2K CORE 
EXECUTION 
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Function 



The FILCOM program is used to compare two versions of a file and to output any differences. 
Generally, this comparison is line by line for ASCII files or word by word for binary files. 
FILCOM determines the type of comparison to use by examining either the switches specified 
in the command string or the extensions of the files. Switches always take precedence over 
file extensions. 



Command Format 



J* FILCOM^ 

*output dev:file.ext [proj,prog] = input dev. :file.ext [pro{,prog], 
input dev_:file.ext [pro|,prog] 

output dev: - the device on which the differences are to be output, 

input dev: = the device on which an input file resides. 

Defaults 

A . If the entire output specification is omitted (including the equal sign), the output device 
is assumed to be TTY . 

2. If an output filename is specified, the default output device is DSK. 

3. If the output filename is omitted, the second input filename is used, unless it is null . In 
this case, the filename FILCOM is used. 

4. If the output extension is omitted, .SCM is used on a source compare and .BCM is used 
on a binary compare. 

5. If the [pro], prog] is omitted (input or output side), the user's default directory is assumed, 

6. If an input device is omitted, it is assumed to be DSK. 

7. If the filename and/or extension of the second input file is omitted, it is taken from the 
first input file. 

8. A dot following the filename of the second input is necessary to explicitly indicate a null 
extension, if the extension of .the first input file is not null . 
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Command Format (cont) 

9. The second input file specification cannot be null unless a binary compare is being per- 
formed. In a binary compare, if the first input file is not followed by a comma and a 
second input file descriptor, the input file is compared to a zero file and is output in its 
entirety. This gives the user a method of listing a binary file. Refer to Example 4. 



Switches 

The following switches can appear in the command string, depending on whether a source com- 
pare or a binary source compare is being performed. 

Binary Compare 

/H Type list of switches available (help text) . 

/nL Specify the lower limit for a partial binary compare (n is an octal number). 

This switch, when used with the /nil switch, allows a binary file to be 
compared only within the specified limits. 

/nil Specify the upper limit for a partial binary compare (n is an octal number). 

This switch, when used with the /nL switch, allows a binary file to be com- 
pared only within the specified limits. 

/W Compare files in binary mode without expanding the files first (refer to 

Appendix D). This switch is used to compare two binary files with ASCII 
extensions. 

/X Expand SAV files before comparing them in binary mode. This action re- 

moves differences resulting from zero compression (refer to Appendix D). 

Source Compare 

/A Compare files in ASCII mode. This switch is used to force a source com- 

pare on two ASCII files with binary extensions. 

/B Compare blank lines. Without this switch, blank lines are ignored. 

/C Ignore comments (all text on a line following a semicolon) and spacing 

(spaces and tabs). This switch does not cause a line consisting entirely of 
a comment to become a blank line, which is normally ignored. 

(continued on next page) 
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Command Format (cont) 



Source Compare (cont) 



/H Type list of switches available (help text). 

/nL Specify the number of lines that determine a match (n is an octal number). 

A match means that n successive lines in each input file have been found 
identical . When a match is found, all differences occurring before the 
match and after the previous match are output. In addition, the first line 
of the current match is output after the differences to aid in locating the 
place within each file at which the differences occurred. The default 
value for n is 3. 

/S Ignore spaces and tabs. 

/U Compare in update mode. This means that the output file consists of the 

second input file with vertical bars next to the lines that differ from the 
first Input file. This feature is useful when updating a document because 
the changes made to the latest edition are flagged with change bars in the 
left margin. The latest edition of the document is the second input file. 

If switches are not specified in the command string, the files are compared in the mode implied 
by the extension. The following extensions are recognized as binary and cause a binary com- 
pare if one or both of the input files have one of the extensions. 



.BAC 


.HGH 


.RMT 


.BIN 


.LOW 


.RTB 


.BUG 


.MSB 


.SAV 


.CAL 


.OVR 


.SFD 


.CHN 


.QUE 


.SHR 


.DAE 


.QUF 


.SVE 


.DCR 


.REL 


.SYS 


.DMP 


.RIM 


.UFD 
.XPN 



Binary files are compared word by word starting at word except for the following two cases: 

1 . Files with extensions .SHR and .HGH are assumed to be high segment files. Since 
the word count starts at 400000, upper and lower limits, if used, must be greater 
than (or equal to in the case of the lower limit) 400000. 

2. Files with extensions .SAV, .LOW, and .SVE are assumed to be compressed core 
image files and are expanded before comparing. 
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Command Format (cont) 

Conflicts are resolved by switches or defaults. If a conflict arises in the absence of switches, 
the files are assumed to be ordinary binary files. 

Output 

In most cases, headers consisting of the device, filename, extension, and creation date of 
each input file are listed before the differences are output. However, headers do not appear 
on output from the /U switch (update mode on source compare). 

Source compare output - After the headers are listed, the following notation appears in the 
left column of the output 

n)m 

where 

n is the number of the input file, and 

m is the page number of the input file (see examples). 

The right column lists the differences occurring between matches in the input files. Following 
the list of differences, a line identical to each file is output for reference purposes. 

The output from the /U switch differs from the above-described output in that the output file 
created is the second input file with vertical bars in the left column next to the lines that are 
different from the first input file. 

Binary compare output - When a difference is encountered between the two input files, a line 
in the following format appears on the output device: 

octal loc. first file-word second file-word XOR of both words 

If the exclusive OR (XOR) of the two words differs only in the right half, the third word output 
is the absolute value of the difference of the two right halves. This usually indicates an ad- 
dress that changed . 

If one input file is shorter than the other, after the end of file is encountered on the shorter 
file, the remainder of the longer file is output. 
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Characteristics 



The R FILCOM command: 

Places the terminal in user mode. 

Runs the FILCOM program, thereby destroying the user's core image. 



Associated Messages 








Refer to Chapter 4. 






Examples 




■ 


1 . The user has the 


following two ASCII files on 


disk: 


First File 


Second File 

FILE B 




FILE A 


i 


I 


A 


A 






B 


B 






C 


C 






D 


G 






E 
F 


H 

I . 


Pag 


el 


G 


J 






H 


1 






I 


2 






J 


3 






K 








L 

M 




^ 


r 


First File 


Second File 

N 





N 



i 


k 


P 


P 






Q 


Q 






R 


R 






S 


S 






T 

U 


T 

U 


pas 


ie2 


V 


V 






W 


A 






X 


5 






Y 


W 






Z 


X 








Y 
Z 


1 


r 



(continued on next page) 
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Examples (cont) 



To compare the two files and output the differences on the terminal, the following sequence 
is used: 



^R FILCOM^ 
*FILEA,FILEBj 



Run the FILCOM program. 

Compare the two files on disk and output the dif- 
ferences on the terminal. By default, three consec- 
utive identical lines determine a match. 



headers 


1 FILE 
w ^FILE 


1 ) 


DSK:FILEA 


2) 


DSK:FILEB 


line 

identical 
in both 
files 


1)1 FILE A^c 
-^1> A ^-^ 

^^^ 2>1 FILE B^ 

** ************ 




1)1 




D 1 




1 ) 




E / "^ 


line 


1) 




F J 


identical 
in both 


<T ** * * 

^""^2)1 




G 

G 


files 


****=( 


k** 


******* 





************** 




> 



CREATED: 1456 17-JAN-1972 
CREATED: 1456 17-JAN-1972 



Rrst difference 



Second difference 




Third difference 



Fourth difference 



************** 

t * — This column indicates the page number of the file. 

' This column indicates either the first file or the second file. 



(continued on next page) 
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Examples (cont) 



To compare the two files and output the differences on the line printer, the following commands 
are used. Note that in this example the number of successive lines that determines a match has 
been set to 4 with the/4L switch. 



.R FILCOM J 








♦LPT :/4L=F ILEA 


,FILEBj 


FILE 


1 ) 


DSK:I 


"ILEA 


FILE 


2) 


DSK:l 


"ILEB 


1)1 




FILE 


A 


1) 




A"^ 




1) 




B L 




1) 




C J^ 




1) 




D 




1) 




E 




1) 




F 




1) 




G 




**** 








2)1 




FILE 


*S 


2) 




Mi, 


S^ / 


2) 




B l> 




2) 




C J 




2) 




G 




************** 


1)1 




K 




1) 




L 




1) 




M 




1)2 




N 




**** 








2)1 




1 




2) 




2 




2) 




3 




2)2 




N 




************** 


1)2 




W 




**** 








2)2 




4 




2) 




5 




2) 




W 





CHEATED: 
CREATED: 



1456 17-JAN-1972 
1456 17-JAN-1972 



These lines"are listed as being different because 
the /4L switch specifies that 4 consecutive lines 
must be found identical in the two files before they 
are considered as a match . 



************** 



(continued on next page) 
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Examples (cont) 



To compare the two files so that the second input file Is output with vertical bars in the left 
cola™ next to the lines that differ from the first input file, use the followin 8 conlnd £ 

iR FILCOM J 

*LPT : /U=F I LEA , F I LEB^ 

FILE B 



A 

B 

C 

G 

H 

I 

J 

1 

2 

3 

N 



P 



R 

S 

T 

U 

V 

4 

5 

W 

X 

Y 

Z 



The lines with vertical bars indicate the differences 
between the two files. 



The lines with vertical bars indicate the differences 
between the two files. 



2. 



To compare two binary files on the disk and output the differences on the terminal, use 
the to I lowing command sequence. 

iR FlLCOMj 

*TTY:-DSK:DIAL.REL,DIAL2j 

FILE 1) DSK.DIAL.REL CREATED: 0000 23-DEC-1971 

FILE 2) DSK.DIAL2.REL CREATED: 0000 12-AUG-1971 



000000 000004 000001 

000002 000000 054716 

000003 000006 000001 

000004 000000 000000 



000004 000060 
000311 372712 
017573 510354 
017573 513216 



000057 
00031 1 326004 
017575 510355 
17573 513216 



Version 16 FILCOM 



2-88 



-551 - 



COMMANDS 



FILCOM program (Cont) 



Examples (cont) 



3. 



To compare two high segment files, the command sequence below is used. Note that th( 
locations begin at 400000. 

•R FILCOM^ 

*TTY:-SYS:TABLE.SHk, TABLE: .SHR J 

FILE 1) SYStTABLE.SHR CREATED: 2020 24-JAN-1972 

FILE 2) DSK:TABLE.SHR CREATED: 1829 30-NOV-1971 



400000 


00161 1 


400010 


001630 


407157 


00002 1 


007147 


400003 


006675 


000000 


015024 


407670 


013651 


407670 


400004 


005600 


000070 


004700 


0001 13 


001 100 


000163 


400005 


545741 


444562 


554143 


625700 


1 1602 


261262 


400010 


634000 


000000 


260740 


403516 


454740 


403516 


40001 1 


474000 


000000 


200000 


414036 


674000 


414036 


400012 


402000 


000156 


202000 


000720 


600000 


000676 


400013 


200040 


4063 54 


201000 


000472 


001040 


406726 



4. To list a binary file, use the following command sequence. 



..R FILC 

*TTY:-S 

000000 

000001 

000002 

000003 

000004 

00000 5 

000006 

000007 



YS:D0T. 
000004 
000000 
000000 
000006 
000000 
000007 
000001 
000000 



REL^ 
000001 
000000 
054716 
000001 
000000 
517716 
000002 
000000 



Note that the following sequence will not work because of the terminating comma. 
*TTY :«-SYS :D0T .REL*^> 
7C0MMAND ERROR 
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Examples (cont) 



5. To compare two binary files between locations 150-160 (octal). 

.R FILCOM^ 

*TTY:/1 50L/1 60U-SYS :S YSTAT .SAV,SYS :SYSDPY .SAV^ 
FILE 1) SYS.'SYSTAT.SAV CREATED: 0818 30-NOV-1971 
FILE 2) SYS:SYSDPY.SAV CREATED: 1642 29-N0V-1971 



000150 
000151 
000152 
000153 
0001 54 
000155 
000156 
000157 
000 1 60 



200400 
260740 
2 60 740 
200040 
260740 
201041 
047040 
2 54000 
476000 



000137 
004226 
004253 
00 501 1 
004063 
777777 
000042 
000174 
006774 



200740 
404500 
661500 
260740 
200040 
202040 
200040 
251040 
21 1040 



003217 
004242 
002000 
002723 
004243 
003241 
004241 
004142 
000144 



000340 
664240 
401240 
060700 
060700 
003001 
247000 
005040 
667040 



003320 
000064 
0062 53 
007732 
000220 
774536 
004203 
004036 
006630 



6. To compare two .SAV files. Note that the files are expanded before the comparison. 



..R FILCOM^ 

*TTY:*-SYS:TRY1 .SAV,SYS:TRY.SAV J 
FILE 1) SYS:TRY1.SAV CREATED: 

FILE 2) SYS:TRY.SAV CREATED: 



2043 
0818 



05-JAN-1972 
30-NOV-1971 



0001 14 

0001 16 

0001 17 
000120 
000121 
000130 
000133 
000137 
000140 
000141 
000142 
000143 
000144 
000145 
000146 
000147 
000 1 50 
000151 
000 1 52 
000153 



004000 
777536 
000000 
006000 
000000 
010000 
003727 
003400 
264000 
260040 
201240 
542240 
260040 
621000 
200240 
251240 
402000 
201040 
200260 
321240 



000140 
005536 
005536 
000140 
006000 
000005 
005777 
000070 
001454 
001773 
001447 
001634 
002774 
000010 
003504 
000012 
003613 
003730 
003632 
000164 



000000 
000000 
000000 
007222 
000000 
000000 
006643 
046700 
047000 
200040 
402000 
251040 
403000 
476000 
200740 
051 140 
200400 
260740 
260740 
200040 



000000 
000000 
000000 
000140 
007222 
000000 
007777 
000004 
000000 
005075 
006644 
007221 
000015 
006715 
006606 
005076 
000137 
004226 
0042 53 
00 501 1 



004000 
777536 

001222 

010000 
005164 
045300 
223000 
60000 
603240 
713200 
663040 
257000 
000500 
200300 
602400 
061700 
060520 
121200 



000140 
00 5536 
005536 
000000 
001222 
000005 
002000 
000074 
001454 
004706 
007203 
006415 
002761 
006705 
005302 
005064 
003724 
007516 
007461 
005175 
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Function 



The FILE command provides remote control of DECtape-to-disk and disk-to- DECtape transfers 
on operator-handled DECtapes. 



Command Formats 



1 . FILE C 



Checks the queue of FILE commands to be read to determine if any of the user's re- 
quests are still pending. No argument is required. Pending requests will be listed. 

2. FILE D, id, file. ext, file. ext, ... 

Deletes the specified files from DECtape. Requires Tape ID and list of filenames as 
arguments. The tape ID is any alphanumeric name of 6 characters or less that is used 
to identify the tape. Upon completion, an automatic FILE L is performed. 

3. FILE F, id, file. ext, file. ext, ... 

Files information onto a DECtape. Requires Tape ID and list of filenames as arguments. 
Upon completion, an automatic FILE L is performed. 

4. FILE L, id 

Reads the directory of a DECtape and places it in the user's disk area as an ASCII file 
with filename id.DIR. id is any alphanumeric name of 6 characters or less that is used 
to identify the tape. It is the only argument. The user may then read the directory 
with a monitor command string. (See Examples). 

5. FILE R, id, file. ext, file.ext, ... 

Recalls (transfers) information from the user's DECtape to the disk. Requires Tape id 
and list of filenames as arguments. If the specified files already exist, they are 
superseded with the ones from the DECtape. If the specified files do not exist, they 
will be created on the first file structure in the job's search list for which creation is 
allowed. After the files are transferred, an automatic FILE L is performed. 
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Command Formats (cont) 

6. FILE W 

Waits until all of the user's pending requests are processed before continuing. If there 
are pending requests, the message WAITING ... is typed to the user. Control returns 
when all requests have been processed. The user may type control-C if he decides 
not to wait. 

7. FILE Z, id, file. ext, file. ext, .. . 

Zeroes the directory of the DECtape before the files are copied and then performs the 
same operations as the F option. Requires Tape id and may have a list of filenames as 
arguments. After the files are copied, an automatic RLE L is performed. 

The C and W funcitons are the only requests that are performed immediately. The other re- 
quests are placed in a queue to be performed whenever possible. The user's terminal and job 
are free to proceed before the request is completed. The function? argument is optional . If the 
function argument is not specified, a brief dialogue is performed. 

In most cases the user does not need to specify which file structures the files are on because 
U MOUNT determines this (with LOOKUPs) and passes the information to OMOUNT. 

However, file structure names may be specified in file descriptors. When no structure name is 
explicitly typed, the default is initially the first file structure in the user's search list (implied 
by DSK:) on which he is allowed to create files. Refer to the description of the SETSRC pro- 
gram. When a file structure name is typed or implied, it becomes the new default. 

The asterisk construction may be used, but care should be taken when generic DSK: is typed. 
Because DSK: may define many file structures, the single file structure is chosen as follows: 

When the asterisk construction is used for the filename or extension, the first structure 
on which the user may create files in his search list is used. This is called the user's 
standard file structure. 

If the asterisk construction is not used and the file exists, the first file structure in the search 
list that contains the specified file is used, unless overridden by a default. (See Examples.) 
If the file does not exist, the standard structure is used. 

WARNING 
If the user has a search list with multiple file structures, 
the asterisk construction when used with the FILE R com- 
mand can cause files to be created rather than superseded. 
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Characteristics 



The FILE command: 



Leaves the terminal in monitor mode. 

Runs the UMOUNT program, thereby destroys the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040, 



Restrictions 



The project-programmer number may not be specified in file descriptors. 

Associated Messages 

Refer to Chapter 4. 

Examples 

.FILE R,MINE,MAIN.F4»SUBFIL.MACJ The files MAIN. F4 and SUBFIL.MAC are taken 
"~ from the user's DECtape labeled MINE and placed 

on the first file structure in the user's search list 
^tt"J $TQgED f or w hi c h creation is allowed. There are two com- 

2, COMMANDS IN_QUEUE m£jnds |n ^ queue {comflt ^ th|$ one) . 

.FILE CJ , 

?. R J0J24 TTY5 27,235 MINE DSXB1 , DjKB :MAIN,F4, SjJBf IL.MAC J 
3. COMMANDS IN QUEUE The user checks to see if his request is still waiting 

to be processed. The first line of the output indi- 
cates that the user's request is second in the queue 
(2.), that the request made is a RECALL (R), that 
the user's job is 24 (JOB24), that the user is on 
terminal 5 (TTY5) under the project-programmer 
number of [27,235] (27,235), that the tape is iden- 
tified by the name MINE (MINE), and that the files 
will be written in the directory on DSKB: (DSKB:). 
The second line indicates that there are 3 commands 
in the queue. 

(continued on next page) 
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Examples (cont) 

.FILE L, ij 

.TYPE 4.D1RJ 



The user wants the directory on the DECtape labeled 
4 to be placed in his disk area as an ASCII file. 

The user then reads the directory file with the 
TYPE command. 



If the user's search list is as follows: 

DSKA/N, DSKB, DSKC 

with file A on DSKA, file B on DSKB, and file C on DSKC, the following commands are 
equivalent: 



The user types: 



The user could have typed: 



The command as passed to OMOUNT: 



.FILE F,2,A,B,C .FILE F, 2, DSK * A, DSKIB, .FILE F,2,DSKA:A, DSKBlB, 

DSKIC DSKC:C 

The first file structure that contains each file is used. 

.FILE R,3,A,DSK0;B.C .FILE R. 3. DSK » A. DSKBlB, .FILE R»3,DSKA 1 A, DSKB:B f 

DSKBtC DSKBIC 

The user changes the default to DSKB and even though file C exists on DSKC, file C is created 
on DSKB; files A and B are superseded. 



• FTL.F F#l,*.* 



.FILE F>l*DSk;*.* 



•FILE F*l *DSKB:*.* 



Because the asterisk convention was used, the first file structure on which the user may create 
files (DSKB) is used. 



.FILE R*2*A,C** 
DSKC :B.* 



.FILE fo£!,DSK:A* 
DSKB:C*,DSKC:B.* 



.FILE R>2,DSKA:A, 
DSKB :C.*,DSKC:B.* 



Because of the asterisk convention, DSKB is used for file C (even though file C exists on 
DSKC). The user explicitly typed a structure name for file B; therefore, DSKC is used e\ 
though file B 3s on DSKB. File A is superseded. 
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FILEX program 



Function 



The FILEX program is a genera! file transfer program intended to convert between various core 
image formats, and to read and write various directory formats. Rles are transferred as 36-bit 
data. The only processing on the data is that necessary to convert between various core image 
representations. 



Command Format 



.R FILEX^ 

*dev:ofile.ext [proj,prog] <nnn>/sw?tches = dev:ifile.ext [pro j, prog] /switches 

If the project-programmer and/or the switches appear after the device name, they 
apply to all the following files. If they appear after the filename, the specifiers 
apply only to the preceding file. The input filename or extension may be * in which 
case the usual processing of the * construction occurs (refer to the TYPE command). 
The output filename and extension may be * in which case the filename and extension 
of the input file is copied. If the output filename or extension is missing, the same 
procedure occurs as with the * construction, except that all core image files are 
written with the default extension and format appropriate to the output device (unless 
overridden by switches). 

If a protection <nnn>is not specified, files are written with the system standard pro- 
tection unless the files are being written on SYS. On SYS, files are written with pro- 
tection <155>, except for files with extension .SYS. These files have the default 
protection of < 157 >. 

Meaning of Switches: 

Help text 

/H - to obtain an explanation of the command string and individual 
switches. 

DECtape Format Specifiers 

/J? - PDP-15 DECtape format 

/M - MIT project MAC PDP-6/10 DECtape format 

/O - Old DEC PDP-6 DECtape format 

/T - normal PDP-10 directory format 

/V - PDP-1 1 DECtape format (Note that PDP-1 1 contiguous files are 
not supported by FILEX.) 
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Command iFormat (cont) 



File Format Specifiers 

/A - ASCII processing; meaningful only for PDP-11 and PDP-15 tapes. 

/B - binary processing; overrides default extension. 

/C - compressed; save file format. This format is assumed for files with 
extensions .SAV, .LOW, ,SVE. The default output extension is 
• SAV unless the input extension is .LOW or .SVE, in which case 
the extension remains unchanged. 

/D - dump format. This format is assumed for files with extension .DMP. 

/E - expanded core image files (used by FILDDT). This format is assumed 
for files with extension ,XPN. The default output extension is 
.XPN. 

/I - image processing; meaningful only for PDP-11 and PDP-15 tapes. 

/S - simple block (SBLK) format, project MAC's equivalent of .SAV for- 
mat. The default output extension is .BIN. 

DECtape Processing Specifiers 

/G - (go on), ignores read errors on input device. FILEX checks the 

always-bad-checksum bit in the 5-series monitor, so this switch is 
not needed for files with .RPABCon (e.g., CRASH. SAV). 

/L - (list), causes a directory on an input DECtape file to be typed on 
the terminal, or causes a directory listing of the output DECtape at 
the end (i .e. , after the output). 

/P - (preserved), causes quick processing (/Q) and preserves the scratch 
file after processing for use by another command. 

/Q - (quick), causes an input or output DECtape to be processed quickly 
via a scratch file. 

/R - (reuse), reuses a scratch file preserved by a /P in a previous com- 
mand . 

/Z - /zero), causes the appropriate format of a zeroed directory to be 

written on a DECtape output file. If TAPEID appears in the output 
specifier, then TAPEID is written as the tape identifier in the direc- 
tory . TAPEID is preceded by a up arrow (t) and may be 6 characters 
on a PDP-10 tape, 3 characters on a project MAC tape, and is not 
present on a PDP-6 tape. 
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Characteristics 

The R FILEX command: 

Runs the FILEX program, thereby destroying the user's core image. 

Examples 

i 

•R FILEX^ The dump format file is com- 

: *DSK:-DTA1 :TEST.DMP/C pressed and written as TEST. SAV. 

•H FILEX Copy CRASH. SAV to an ex- 

*DSK:SER105.XPNC10*1 3-DSKC :CRASH .SA V [ 1 ,43 ponded format file for FILDDT 

to examine. 



Version 15 FILEX 2-97 



COMMANDS - 560 - 



FINISH command 



Function 



The FINISH command terminates any input or output currently in progress on the specified de- 
vice and automatically performs the RELEASE UUO (which CLOSES the files) and DEASSIGN 
command, thus making the device available to another user. This command is preferred over 
the DEASSIGN command because it completely disassociates an INITed device from the user's 
job, thereby preventing the user from continuing his program. If the user wishes to continue 
his program, he should use the DEASSIGN command. 



Command Format 



FINISH dev 



dev - the logical or physical name of the device on which I/O is to be terminated. 
This argument is optional . 

If dev is omitted, I/O is terminated on all devices, except the job's controlling 
terminal and the logical none of the controlling terminal is cleared. 



Characteristics 



The FINISH command: 



Leaves the terminal in monitor mode. 

Requires core. 

Depends on FTFINISH which is normally absent in the DECsystem-1040. 



Restrictions 



The user cannot continue his program if the device was INITed, but he can start at the begin- 
ning or enter DDT. 

Associated Messages 

Refer to Chapter 4. 
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Examples 



^FINISH CDRt^ 
Tfinish DTA7;J 
..FINISH LPTtj 
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J FUDGE command 1 



Function 



The FUDGE command causes PIP to read a temporary file generated by a previous COMPILE, 
LOAD, EXECUTE, or DEBUG command using the /FUDGE switch and to create a library REL 
file. The library is created with ihe REL files in the same order in which they were specified 
in the command string containing the /FUDGE switch. 

NOTE 
Since the COMPIL program sorts out files by compilers, mixed 
FORTRAN and MACRO programs are sorted so that all 
FORTRAN programs are compiled first and MACRO programs 
second. However, the /FUDGE switch combines them in the 
order in which the COMPIL program encountered them . 



Command Format 
FUDGE 

Characteristics 

The FUDGE command: 

Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 

Associated Messages 

Refer to Chapter 4. 

Examples 

^COMPIL/FUDGEJLIBARY/MACHO TEST, MATH, DATPRO.CBl, SCIENC.F4^ 

Create a disk file named LIBARY which contains the names of all the 
REL files produced. 



^fUDGEj 



Create the library file and call it LIBARY. This file contains the following' 
TEST. REL, MATH. REL, DATPRO.REL, and SCIENC.REL. 



This command runs the COMPIL program, which interprets the command before running the PIP 
program . 
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Function 



The FUDGE2 program is used to update files containing one or more relocatable binary pro- 
grams and to manipulate programs within program files. Three files are used in the updating 
process: 

1 . A master file containing the file to be updated. 

2. A transaction file containing the file of programs to be used when updating. 

3. An output file containing the updated file. 

All three files can be on the same device if the device is DSK. The two input files can be on 
the same DECtape. 

The desired function of FUDGE2 is specified by a command code at the end of the command 
string. Only one command code can be specified in each command string. The command 
string is then terminated with an ALTmode, represented in this manual by a dollar sign ($). 
Switches can also be used to manipulate file directories and to position a magnetic tape. 



Command Format 



J* FUDGE2> 

-output dev:file. exr=master dev:file.ext<programs>, transaction dev:file.ext<programs> 
(command)$ 



output dev: 
master dev: 
transaction dev: 



file.ext 



; the device on which the updated file is written. If omitted, 
DSK is assumed . 

the device containing the file to be updated. If omitted, the 
default is DSK. 

the device containing the files of programs to be used in the 
updating process. When more than one file is transferred from 
magnetic tape or paper tape, a colon must follow the device 
name for each file. For example, 



MTA: 



Transfer 3 files 



If the device is omitted, DSK is assumed. 

the filename and extension of each file. Filenames must be 
specified for directory devices, but the extension can be omitted. 
If the extension is not given, it is assumed to be .REL unless the 
/L switch appears in the command string. In this case, the output 
extension .LST is assumed. 

(continued on next page) 
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Command format (cont) 

file.ext (cont) 



<progirams> 



(command) 



Project-programmer numbers appearing after a filename apply 
to that file only. If the project-programmer number appears 
before the filename, it applies to all subsequent files until 
another device is specified. 

The asterisk convention can be used with the input files (refer 
to Paragraph 1.4.2.4). 

: Names of programs (on DSK or DTA only) to be used in the up- 
dating process. They are grouped within angle brackets in the 
same order as they appear in the file and are separated by 
commas. When manipulating all the programs within a file, 
only the filename need be specified. Program names cannot 
appear for the output file. 

: Code for the function to be performed. This code can be either 
preceded by a slash or enclosed in parentheses and must appear 
at the end of the command string. Each command results in the 
updated file being output to the output device. The command 
codes are as follows: 



A 

C 
D 
E 

H 
I 



Append the specified programs in the transaction file(s) 
to the master file. 

Delete local symbols from the master file. 

Delete the specified programs from the master file. 

Extract the specified files and/or programs from the 
jnput files. The entire file is extracted if program 
names are not specified. 

Type the commands and switches available. 

Insert programs from the specified transaction files into 
the master file. The programs from the transaction files 
are inserted immediately before the specified programs 
in the master file. 

List the names and lengths of all relocatable programs 
within a file. The length is in one of two forms: 

low segment break, high segment break or 
program break, absolute break 

The length of FORTRAN programs is not output. 

(continued on next page) 
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Command Format (cont) 



(command) (cont) R 

S 
X 



Replace the specified programs in the master file with 
the specified programs in the transaction file. The num- 
ber of replacing programs must be the same as the num- 
ber of programs to replace. 

List all the entry points within a program. These entry 
points are listed across the page. 

Write index blocks into a library file. Index blocks 
are used in a direct access library search (refer to the 
LOADER documentation). This command implies a C 
command . 



File directories can be manipulated and magnetic tapes positioned by including switches in the 
command string. These switches can appear anywhere in the command string and are preceded 
by a slash or enclosed in parentheses. The following switches are available: 

/B Backspace a magnetic tape one file. 

/K Advance a magnetic tape one file. 

/■ Skip to the logical end of- tape on a magnetic tape. 

AN Rewind a magnetic tape. 

/Z Clear the directory of the output DECtape. 



Characteristics 

The R FUDGE2 command: 

Places the terminal in user mode. 

Runs the FUDGE2 program, thereby destroying the user's core image. 

Associated Messages 

Refer to Chapter 4. 
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FUDGE2 program (Cont) 



Examples 



*R FUDGE2y> List all relocatable programs (.REL) from the file 

*LPT:=DTA1 : Li 8 40 CDS LIB40, located on DTA1 , on the line printer. 

*U;>K:LIB4BB=DTA2:LIB4AA *<EXP .3>EXP .3C ># 

DTA1 :F4<EXP.3A,EXP.3B>CR >S Rep | ace programs EX p.3 and EXP.3C located in 

file LIB4AA on DTA2, with programs EXP.3A and 
EXP.3B in File F4on DTA1; write out the new 
LIB4AA file on disk and call it LIB4BB. 



DTA3:TFILEA<TA1 ,TA2> 
DTA4:TFILEB<TB1 ,TB2>/I$ 



*DTA1 :NFILE=DSK:KFILE<M1 ..M2,M3>M4> 

Insert into MFILE the programs TA1 and TA2 from 
TFILEA, and TBI and TB2 from TFILEB. Create 
NFILE with the following order: 

TAT ,M1 ,TA2,M2,TB1 ,M3,TB2,M4 

Insertion is on a one-to-one basis. If there are 
more programs to be inserted than specified pro- 
grams before which they are to be inserted, the 
extra files are ignored. 

*j)TAl :NFILE=DSK:MFILE<M1 *M2.,M3jM4> 

DTA3 :TF ILEA However, in this example (where TFILEA and 

DTA4STFILEB/IS tcii cd •. • u. tat j tao j tdi 

TFILEB contain the programs TA1 and TA2 and TBI 

and TB2, respectively) create an NFILE with the 

following order: 

TA1 ,TA2,M1 ,TB1 ,TB2,M2,M3,M4 
*DTA2:TESTA=MTA1 : <WK>»MTA2: : (ZA)S 

Clear the directory of DTA2; rewind MTA1 and ad- 
vance the tape one file; append the first two pro- 
gram files from MTA2 to the second file on MTA1 
and write out the resultant file on disk, calling it 
TESTA. 

*0UTPUT=LIBARY,DTA1 : L I BAR Y<F I LEY*F I LEZ>/A$ 

Append the programs FILEY and FILEZ contained 
in the file LIBARY on DTA1 to the end of the file 
LIBARY on disk. Write the new file on disk and 
call it OUTPUT. 



(continued on next page) 
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Examples (cont) 



*NFWFIL=OLDFIL<TEST#SUBTRC>MULTI>,BASFIL<PkOG, 

ROUTIN,ANSWER>#SUBFIL<MATH>(E>$ Extract the specified programs from the files 

OLDFIL, BASFIL, and SUBHL and create a new 
output file called NEWFIL. The order of the pro- 
grams in NEWFIL is as follows: TEST, SUBTRC, 
MULTI, PROG, ROUTIN, ANSWER, MATH. 

*tc Return to the monitor. 
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GET command 



Function 



The GET command loads a core image from a retrievable storage device but does not begin 
execution. 

This command clears all of user core. However, programs should not count on this action and 
should explicitly clear those areas of core that are expected to contain zeroes (i.e., programs 
should be self-initializing). This action allows programs to be restarted by a tC, START 
sequence without having to do another GET command. 

On magnetic tape, if the low or high segment is missing, a null record is output before the 
EOF for the missing segment so that two EOFs cannot occur consecutively. Therefore, a 
saved null segment does not appear as a logical EOT (2 EOFs in a row). 



Command Format 



GET devrfile.ext [proj,prog3 core 

The arguments and the defaults are the same as in the RUN command. 

The extension applies to the low file, not the high file. An extension of .SHR, then 
. HGH, is assumed for the high file. If the user types an extension of .SHR or .HGH, 
the extension is treated as a null extension since .SHR and .HGH are confusing as low 
file extensions. 



Characteristics 



The GET command: 



Leaves the terminal in monitor mode. 

Does not operate when the device is currently transmitting data. 



Associated Messages 

Refer to Chapter 4. 

Example 

^GET SYS:pipJ 
JOB SETUP 

..GET TEST*> 
JOB SETUP 
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Function 



The GLOB program reads multiple binary program files and produces an alphabetical cross- 
referenced list of all the global symbols (symbols accessible to other programs) encountered. 
This program also searches files in library search mode, checking for globals, if the program 
file was loaded by the LOADER in library search mode (refer to the LOADER documentation). 

The GLOB program has two phases of operation; the first phase is to scan the input files and 
build an internal symbol table, and the second, to produce output based on the symbol table. 
Because of these phases, the user can input commands to GLOB in one of two ways. The first 
way is to specify one command string containing both the output and input specifications. 
(This is the command string format most system programs accept.) The second is to separate 
the command string into a series of input commands and output commands. 



Command Formats 



1 . R GLOB 



outdev:file.ext[proj,prog] = input devrfile. ext [pro}, prog] , file. ext, .. .,dev:file.ext 
[pro|,prog] © 

2. RGLOB 

followed by one or more input commands in the form 

devrfile.ext [pro}, prog] ,file ,,ext [pro}, prog] ,..., devrfile.ext [pro}, prog] ,. . . J 
and then one or more output commands in the form 
outdev:file.ext[proj,prog] = (£) 

When the user separates his input to GLOB into input commands and output commands (Com- 
mand Format *2), the input commands contain only input specifications and the output com- 
mands, only output specifications. Each output command causes a listing to be generated; 
any number of listings can be printed from the symbol table generated from the current input 
files as long as no input commands occur after the first output command. When an input com- 
mand is encountered after output has been generated, the current symbol table is destroyed 
and a new one begun . 

Defaults 

1 . If the device is omitted, it is assumed to be DSK. However, if the entire output specifi- 
cation is omitted, the output device is TTY. 

(continued on next page) 



Version 5 GLOB 2-107 



COMMANDS 



-570 - 



GLOB program (Contfj 



Command Format (conr) 
Defaults (cont) 

2. If the output filename is omitted, it is the name of the last input file. The input filenames 
are required. 

3. If the output extension is omitted, .GLB is used. If the input extension is omitted, it 

is assumed to be .REL unless the null extension is explicitly specified by a dot following 
the filename. 

4. If the project-programmer number [pro|,prog] is omitted, the user's default directory is 
used . 

5. An ALTmode terminates the command input and signals GLOB to output the cross-referenced 
listing. In other words, a listing is not output until GLOB encounters an ALTmode. The 
ALTmode appears at the end of the command string shown in Command Format #1 or at the 
end of each output command shown in Command Format #2. 

Switches 

Switches control the types of global listings to be output. Each switch can be preceded by a 
slash, or several switches can be enclosed in parentheses. Only the most recently specified 
switch (except for L, M, P, Q, and X, which are always in effect) is in effect at any given 
time. If no switches are specified, all global symbols are output. The following switches are 
available. 

/A Output all global symbols. This is the default if no switches are specified. 

/E List only multiple defined or undefined (erroneous) symbols. 

/F List nonrelocatable (fixed) symbols only. 

/H List the switches available (help text). 

A Scan programs only if they contain globals previously defined and not yet 

satisfied (library search mode). 

/M Turn off library search mode scanning resulting from a A switch. 

/N List only symbols which are never referenced. 

/P List all routines that define a symbol to have the same value. The routine 

that defines the symbol first is listed followed by a plus (+) sign. Subse- 
quent routines that define the symbol are listed preceded by a plus sign. 

/Q Suppress the listing of subsequent definers that result from the /P switch. 

(continued on next page) 
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Command Format (cont) 
Switches (cont) 

A 
/s 

A 



List only relocatable symbols. 

List symbols with no n- conflicting values that are defined in more than one 
program. 

Do not print listing header when output device is not the terminal, and 
include listing header when it is the terminal. Without this switch, the 
header is printed on all devices except the terminal. The listing header is 
in the following format: 

FLAGS SYMBOL OCTAL VALUE DEFINED IN REFERENCED IN 

Symbols listed are in alphabetical order according to their ASCII code 
values. The octal value is followed by a prime (') if the symbol is relo- 
catable. Trie value is then relative to the beginning of the program in 
which the symbol is defined. Flags preceding the symbol are shown 
below . 

M Multiply defined symbol (all values are shown). 

N Never referred to (i.e., was not declared external in any of 

the binary programs). 

S Multiply specified symbol (i.e., defined in more than one 

program but with non-confKcting values). The name of the 
first program in which the symbol was encountered is followed 
by a plus sign. 

U Undefined symbol . 



Characteristics 



The R GLOB command: 



Places the terminal in user mode. 

Runs the GLOB program, thereby destroying the user's core image. 



Associated Messages 



Refer to Chapter 4. 
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Examples 

.R GLOB^ Run the GLOB program. 

*LPT:=MAIN,DTA2:SUB40,SUB50 (?) All global symbols in the programs MAIN (on DSK), 

SUB40, and SUB50 (on DTA2) are listed on the line 
printer. Along with the symbol is listed its value, 
the program in which it is defined, all programs in 
which it is referenced, and any error flags. 

*pTA4:BATCH. REL* DATA, DTA6: NUMBER. RELjCLASSJ 



♦f)SK:MATH.REL*LIBARY. J 

*LPT:=/F © 
*DSKtSYMBOL = /R (D 



*TTY:=/E ($) 

U EXTSYM SUBRTE 



*irC 



The programs to be scanned are BATCH. REL, 
DATA.RELon DTA4; NUMBER. REL, CLASS. REL 
on DTA6; and MATH. REL, LIBARY.null on DSK. 

List only nonrelocatable symbols on the line printer. 

List only relocatable symbols in the file named 
SYMBOL in the user's default directory. 

Print all erroneous symbols on the terminal . EXTSYM 
is an undefined symbol appearing in the program 
SUBRTE. 

Return to monitor mode. 
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Function 



The GRIPE program accepts text from a user and records it in a disk file, thereby enabling users 
to record comments and complaints to be read at a later time by the operations staff. 



Command Format 



R GRIPE 



When the GRIPE program responds with a YES?, type the text, using as many lines as 
necessary, terminated with an ESCAPE. The text is written as a file with <157>pro- 
tection and includes a header with the date, time, and project-programmer number of 
the user writing the comment. Therefore, the user does not need to identify himself. 



Characteristics 



The R GRIPE command: 

Places the terminal in user mode. 

Runs the GRIPE program, thereby destroying the user's core image, 

Associated Messages 

Refer to Chapter 4. 

Example 

•R GRIPE,.) 

YES? (TYPE ESCAPE WHEN THROUGH) THIS CONSOLE IS 
ALMOST OUT OF PAPERS 
THANK YOU 
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Function 



The HALT (tC) command transmits a HALT command to the monitor command interpreter. It 
stops the job and stores the program counter in the job data area (.JBPC). Refer to the 
DECsystem-10 Monitor Calls for a description of the fob data area. 



Command form at 
HALT (tC) 

Characteristics 



The HALT (tC) command: 

Places the terminal in monitor mode. 
Does not require LOGIN. 



Example 
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Function 

The HELP command is used to obtain useful documentation on various system features. 

Command Formats 

1. HELP 

outputs the instructions for receiving information. 

2. HELP* 

outputs the names of features that have available documentation. 

3. HELP name 

outputs the information on the named feature. 

Only the first six characters of the argument to the command are scanned. These characters 
must be A through Z, through 9, or asterisk (*). 

Characteristics 

The HELP command: 

Leaves the terminal in monitor mode. 
Does not require LOGIN. 

Associated Messages 

Refer to Chapter 4. 
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Examples 



jjHELP O 

HELP IS AVAILABLE FOR THE FOLLOWING! 

BATCON CDPSPL CDRSTK D!!RECT FAILSA FGEN 

HELP LPTSPL MATCH MYCOPY PIP PLTSPL 

PTPSPL SOUP TECO 



^HELP DIRECT^ 

TYPE OUT«INPUT+INPUT+... 

/ACCESStN ■ ACCESS ALL LISTED FILES UNDER N BLOCKS LONG 

/ALLOCATED ■ GIVE ALLOCATED LENGTH 

/CHECKSUM • COMPUTE CHECKSUM OF EACH FILE 

/DETAIL ■ EVERYTHING FROM EXTENDED LOOKUP 

/F ■ FAST MODE 

/H ■ THIS TEXT 

/L ■ OUT TO LPT 

/PHYSICAL ■ DO PHYSICAL OPENS 

/S ■ SLOW MODE 

/SORT m PREPARE FOR SORTING 

/SUMMARY ■ JUST PRINT SUMMARY LINE 

/TITLES ■ INCLUDE TITLES 

/UNITS ■ GIVE SPECIFIC UN!£T 

/WIDTHiN ■ TRY TO FILL PAPER WIDTH OF N COLUMNS 

/WORDS « OUTPUT LENGTHS IN WORDS 

* IS WILD NAME, ETC. 

? IS WILD LETTER OF NAME. ETC. 

"OUT-" MAY BE OMITTED 

DEFAULT IS TTY I .DIR»DSK !*„* [MY DIRECTORY] 
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Function 



The INITIA command performs standard system initialization for the terminal issuing the com- 
mand. This command is issued automatically at system startup and at the 400 series restart at 
certain designated terminals, but may be re-issued at any time by the user. This command is 
used to initiate specific system programs, such as the operator service program, OPSER, on a 
particular console. 

The INITIA command runs SYS: INITIA. SAV which, depending upon the system configuration 
and the number of the TTY from which it is typed, may cause any of a number of events to 
occur. For more information, refer to the INITIA specification in Notebook 7 of the 
DECsystem-10 Software Notebooks. 



Command Format 
INITIA 

Characteristics 



The INITIA command: 



Leaves the terminal in monitor mode. 

Runs a specific system program . 

Does not require LOGIN. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 



Associated Messages 



Refer to Chapter 4. 



Examples 



jl_INITIA^ 
5S04 SYS #2 22M2H7 TTY24 
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Function 

The JCONTINUE command forces a continue of the specified job if the job was in a 
tC state because of a call to the device error message routine (HNGSTP). 

Command Format 

JCONTINUE n 

n = the number of the job (to be continued. This argument is required. 

Characteristics 

The JCONTINUE command: 

Places the terminal in monitor mode. 

Does not require LOGIN. 

Depends on FTJCON which is normally absent in the DECsystem-1040. 

Associated Messages 

Refer to Chapter 4. 

Example 

.JCONT 14 J 
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KJOB command 



Function 



In multiprogramming systems, the KJOB command: 

Stops all assigned I/O devices and returns them to the monitor pool. 
Returns all allocated core to the monitor pool. 
Returns the job number to the pool . 
Leaves the console in the monitor mode. 
Performs an automatic TIME command. 

In swapping systems, the KJOB command performs all the above procedures. In addition, the 
command responds with 
CONFIRM: 

The user may type tC to abort logout, or type an optional file structure name (or list of file 
structure names) preceded by one of the following: 

F J to logout immediately saving all files (including temporary files) as they are. 
Identical to R LOGOUT, or RUN UUO to LOGOUT. 

D*> to delete all files on the specified file structures. Responds with ARE YOU 
SURE ? Type Y or D for YES, any other character for NO . 

K^ to delete all unprotected files (i.e., files with Oxx protection code) on the 

specified file structures. If project 1 or other jobs are logged-in with the same 
project-programmer number, responds with ARE YOU SURE? Type Y or K for 
YES, any other character for NO. 

?J to save and protect (i.e., assign a protection code of 1 in the owner's field) 
all but temporary files (TMP, CRF, LST) on the specified file structures. If 
project 1 or other jobs are logged-in with the same project-programmer num- 
ber, responds with ARE YOU SURE? Type Y or P for YES, any other character 
for NO. 

S ) to save without protecting all but temporary files on the specified file struc- 
tures. If project 1 or other jobs are logged-in with the same project-programmer 
number, responds with ARE YOU SURE ? Type Y or S for YES, any other char- 
acter for NO . 

I J to list the directories of the specified file structures. 

I J to individually determine what to do with all files on the specified file struc- 
ture as follows: 

(continued on next page) 
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Function (cont) 



After each filename is listed, type 

P^ to protect the file. 

SJ to save the file. 

KJ to delete the file. 

Q^ to learn if over logged-out quota on this file structure. If not 

over quota, nothing is typed, and the same filename is repeated. 

E J to skip to next file structure and save this file if below logged-out 
quota for this file structure. If not below logged-out quota, a 
message is typed and the same filename is repeated. 

Hj to list responses and meanings. 

Uj to individually determine what to do with all but protected files. Protected 
files are always preserved, 

B^ to delete no files except when user is over the logged-out quota, then delete 
enough files to be below quota. The files are deleted in the following order: 
1) unprotected files according to the category of the file, 2) spooled files not 
previously queued, and 3) protected files according to the category of the file. 
The categories of files are as follows: 1) temporary files, 2) relocatable files, 
3) backup files, 4) save files, and 5) all other files. 

QJ to learn if over logged-out quota on the specified file structures. 

H^ to list the KJOB options and their meanings. 

W^) to list the names of the files that are deleted. 

X J to turn off the listing of the names of the files that are deleted. Complement 
ofW. 

If no file structure names are specified, the responses are for all file structure names in the job 
search list. If file structure names are specified, the responses apply to those file structures, 
and CONFIRM is retyped. The KJOB command ignores all logical assignments. 

The user has the option of going through the CONFIRM dialogue, even if other jobs are logged- 
in under the same project-programmer number or if he is logged-in under project 1 . (However, 
if sufficient responses are included on the KJOB command line or in a temporary file entered 
through an alternate entry point, CONFIRM is not typed.) By responding to a CONFIRM mes- 
sage, the user has an opportunity to organize his disk area by deleting or preserving specific 
files. 

The KJOB program calls the QUEUE program to perform the queuing of files which have been 
deferred to logout time. This includes all spooled output unless the user has specifically 
queued output spooling earlier. Queuing may be suppressed with the /Z response (see below). 
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KJOB command (Cont) 



Command Formats 



1 . KJOB 

CONFIRM: 



When the CONFIRM: response is given, the user may type any of the above-described 
letters followed by an optional file structure name or list of file structure names separ- 
ated by commas. The user may type one of the above-described letters, followed by 
optional file structure names, on the same line as the KJOB command, and the 
CONFIRM: message will not be typed. 

2. KJOB <log file descriptor> =/ <letter> <list of file structure names>/<letter> 
<listof file structure names >* etc. 

<log file descriptor > has the following form: <dev:file.ext [proj,prog] >. If the log 
file is not a disk or spooled device, T7Y is used. 

<letter> = any letter from the above-described set. In addition, the following re- 
sponses are available to any jobs using this command format: 

/Z:n specifies the degree of queuing desired: 

n = suppresses all normal queuing done at LOGOUT time. 

n = 1 queues the log file only. 

n = 2 queues the log file and spooled output (*.LPT, etc.) 

n = 3 queues the log file, spooled output, and *.LST. 

n = 4 queues the log file, spooled output, *.LST, and any requests 

deferred to LOGOUT time (deferred requests are not yet imple- 
mented). 

If Z is given without a value or if there are no spool bits set for job, Z:0 is 
assumed. Otherwise, /Z:2 is assumed. 

/VL:n specifies that the limit of pages for LPT files is to be n (decimal). 

/VC:n specifies that the limit of cards for CDP files is to be n (decimal). 

/VT:n specifies that the limit of feet of paper tape for PTP files is to be n 
(decimal). 

/VP:n specifies that the limit of minutes for PLT files is to be n (decimal). 

/VR:n specifies that the priority of the queue request is to be n; n is from 
through 62. /VR:62 is the standard. 

(continued on next page) 
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Command Formats (cont) 

/VS:n specifies that the sequence number for the queue request is to be n. 

/VD:v specifies that the file disposition of the log file is to be v. 

v = D deletes the log file after printing, 
v = P preserves the log file after printing. 

v = R renames the log file before printing to the queue area and 
deletes it after printing. 

Default is /VD:R. 

If a value to the above switches is not specified, the value is equivalent to 
(e.g. , AD is equivalent to /vT>:0). For the /Vx switches, a value of is 
equivalent to the standard (e.g., /VD = /VD:0 = /VD:R). 

The letters must appear on the input side of the command string. If the log file 
is specified, all TTY output is appended to the log file. If no log file is speci- 
fied or if the log file is not a disk or spooled device, the default is TTY. In 
addition, if responses to CONFIRM are required and are not specified on the 
KJOB command line, these responses will then be read from TTY. Therefore, 
users should be careful when employing this command format. 

3, The KJOB program may be entered at the CCL entry point through the RUN UUO. When 
this is done, TMPCOR file KJO or disk file nnnKJO.TMP, where nnn is the user's job 
number in decimal, is used instead of the TTY input. This temporary file has the follow- 
ing format: 

KJOB <log file descriptor > = / < list of file structure names>/ < letter> 
<list of file structure names > etc. 

Characteristics 

The KJOB command: 

Detaches the terminal . 

Stops all assigned I/O devices since it does not operate when a device is currently 

transmitting data. 
Runs the KJOB and LOGOUT programs. 
Does not require LOGIN. 

Associated Messages 

Refer to Chapter 4. 
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Examples 



1. An example of the CONFIRM dialogue. 

• K J 

CONFIRM: I J 

PS KB : 

TEST4 .TST <055> 2000. BLKS 



kJ 



TESTS 


.TST 


<055> 


505. BLKS 


: F 


Til 


.BAK 


<055> 


5 * B LKS 


! K V 


T2 


.BAK 


<055> 


5. BLKS 


O 


T3 


.BAK 


<055> 


5. BLKS 


i KJ 


TEST 


.BAK 


<055> 


5. BLKS 


! K < 


TEST 


.REL 


<055> 


5. BLKS 


s < 


TEST 


• MAC 


<055> 


5. BLKS 


i V 



TEST 



•SHR <055> 30. BLKS 



Sj 



JOB 5, USER C 10,633 LOGGED OFF TTY24 AT 2309 ll-MAY-71 

DELETED 5 FILES 

SAVED 4 FILES 2565 TOTAL BLOCKS USED 

RUNTIME KINi 00.60 SEC 



2. An example of the user bypassing the CONFIRM dialogue. 



JOB 9: 



USER £10*1103 LOGGED OFF TTY3 1349 18-MAR-71 



SAVED ALL 23 FILES (630. DISK BLOCKS) 
RUNTIME 1 MIN, 51.52 SEC 

3. An example of the command when used in the Batch system. The output appears in the 
log file. 

12:20:51 MONTR K DSKB0 :MUM. LOGC 10, 1 10 3=/W/B/VL:200 

12:21:02 LGOUT JOB 12, USER [10,1103 LOGGED OFF TTY50 1221 18-MAR-71 

12:21:02 LGOUT SAVED ALL 38 FILES (1275. DISK BLOCKS) 

12:21:02 LGOUT ANOTHER JOB STILL LOGGED IN UNDER [10,1103 

12:21:02 LGOUT RUNTIME MIN, 00.65 SEC 



4. An example of the User specifying two switches. 

.K/W/B^ 

DELETED: 

MYFILE 

JOB 14, USER [20,275 3 LOGGED OFF TTY35 1454 13-APK-72 

DELETED 1 FILES C1022. DISK BLOCKS) 

SAVED 52 FILES (1735. DISK BLOCKS) 

RUNTIME MIN, 02.60 SEC 
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Function 



The LIST command directs PIP to list the contents of named source file(s) on the line printer 
(LPT). The output goes either to LPT immediately or to the disk to be spooled to LPT if it is 
being spooled for this job. Refer to the QUEUE and PRINT commands. If the LPT is being 
spooled, the QUEUE program should always be used since it saves time and disk accesses. 



Command Format 



LIST list 



list = a single file specification or a sting of file specifications separated by commas. 
A file specification consists of a device name, a filename and extension, and a direc- 
tory name. This argument is required. 

Switches can be passed to PIP by enclosing them in parentheses in the LIST command 
string. When COMPIL interprets the command string, it passes the switches on to PIP. 



Characteristics 



The LIST command: 



Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 



Associated Messages 

Refer to Chapter 4 . 

Examples 

•LIST TEST.*J 
Tlist *.MAC^ 
TLIST DTA4:A*B,C*> 



This command runs the COMPIL program, which interprets the command before running PIP. 
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Function 



The LOAD command translates the specified source files if necessary (function of COMPILE 
command), runs the LOADER, and loads the .REL files generated. The assembler or compiler 
used is determined by the source file extension or by switches in the command string (refer to 
the COMPILE command). If a REL file already exists with a more recent date than that of 
the source file, compilation is not performed (unless requested via a switch). 

This command generates a core image but does not begin execution. At this point, the user can 
start his program or save the core image for future execution. 

Each time the COMPILE, LOAD, EXECUTE, or DEBUG command is executed, the command 
with its arguments is remembered in a temporary file on disk, or in core if the monitor has the 
TMPCOR feature. Therefore, the filename used last can be recalled for the next command 
without specifying the arguments again (refer to Paragraph 1.5). 

The LOAD command accepts several command constructions: the @ construction (indirect com- 
mands), the + construction, the == construction, and the < > construction. Refer to Paragraph 
1 .5 for a complete description of each of these constructions. 



Command Format 



LOAD list 



list =a single file specification, or a string of file specifications separated by commas. 
A file specification consists of a device name, a filename with or without an exten- 
sion, and a directory name. 

The following switches can be used to modify the command string. These switches can 
be temporary or permanent switches (refer to Paragraph 1 .5.5). 

/ALGOL Compile the file with ALGOL. Assumed for files with the exten- 

sion of .ALG. 
2 
/BLISS Compile the file with BLISS. Assumed for files with the extension 

of .BLI. 

/COBOL Compile the file with COBOL. Assumed for files with the exten- 

sion of .CBL. 



(continued on next page) 



This command runs the COMPIL program, which interprets the command before running the appropriate 
processor and the LOADER. \ 

2 
BLISS will be recognized as a processor only if the appropriate assembly switch is set. However, this 

assembly switch setting is not supported. 



Version 20 COMPIL 2-123 



COMMANDS 



-586 - 



LOAD command (Cont )| 



Command Format (cont) 

/COMPILE 



/CREF 



/FORTRAN 
/FUDGE 



/LIBRARY 



/LIST 



Force a compilation of this file even though a binary file exists 
with a newer date and time than the source file. This switch is 
used to obtain an extra compilation (e.g., in order to obtain a 
listing of the compilation) since normally compilation is not per- 
formed if the binary file is newer than the source file. 

Produce a cross-reference listing file on the disk for each file com- 
piled for later processing by the CREF program. These files have the 
filename of the source file and the extension of .CRF. The files 
can then be listed with the CREF command. However, with COBOL 
files, the cross-referenced listing is always appended to the listing 
file. No additional command need be given to obtain the listing. 

Compile the file with FORTRAN. Assumed for files with the ex- 
tension of .F4 and all files with nonrecognizable processor exten- 
sions (if FORTRAN is the standard processor). 

Create a disk file containing the names of the .REL files produced 
by the command string. When the FUDGE command is given, PIP 
reads this file in order to generate a library REL file. Arguments 
to this switch are: 

/FUDGE:dev:file.ext[proj,prog] 

dev: - the device on which to write the file. DSK: is assumed. 

file.ext - the name of the librdry file. The filename is required. 
If the extension is omitted, it is assumed to be .REL. 

[proj,prog] - the directory in which to place the file. The user's 
directory is assumed if none is given. 

This switch is permanent in the sense that it pertains to all REL files 
generated by the command string. 

Load the files in library search mode. This mode causes a program 
file in a special library file to be loaded only if one or more of its 
declared entry symbols satisfies an undefined global request in the 
sou,rcefile. The default libraries are always searched. Refer to 
the LOADER documentation. 

Generate a disk listing file, for each file compiled, with the file- 
name of the source file and the extension of .LST. These files can 
be listed later with the LIST command. Unless this switch is speci- 
fied, listing files are not generated except in COBOL; COBOL 
listings are always generated. 

(continued on next page) 
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Command Format (cont) 
/LMAP 

/MACRO 

/MAC X 11 

/MAP 



/NOCOMPILE 

/NOLIST 
/NO SEARCH 

/REL 
/SNOBOL 2 



Produce a loader map during the loading process (same action as 
/MAP) containing the local symbols. 

Assemble the file with MACRO. Assumed for files with extensions 
of .MAC. 



Assemble the file with MACX11 
sion of .Pll . 



Assumed for files with an exten- 



Produce a loader map during the loading process. When this switch 
is encountered, a loader map is requested from the loader. After 
the library search of the default libraries, the map is written with 
the filename specified by the user (e.g., /MAP: file) or with the de- 
fault filename MAP. MAP in the user's disk area. This switch 
is an exception to the permanent compi le switch rule in that it 
causes only one map to be produced although it may appear as a 
permanent switch. 

Complement the /COMPILE switch by not forcing a compilation on 
a source file whose date is not as recent as the date on the binary 
file. Note that this switch is not the same as the /ftEL switch, 
which turns off all compilation, even if the source file is newer 
than the REL file. /NOCOMPILE is the default action. 

Do not genergte listing files. This is the default action except for 
COBOL files; COBOL listings are always generated. 

Load all routines of the file whether the routines are referenced or 
not. Since this is the default action, this switch is used only to 
turn off library search mode (/LIBRARY). This is not equivalent 
to the /P LOADER switch because /P does not search any libraries 
where /NO SEARCH will scan the default libraries. 

Use the existing .REL files although a newer source file may be 
present . 

Compile the file with SNOBOL. Assumed for files with an exten- 
sion of .SNO. 



Characteristics 



The LOAD command: 



Leaves the terminal in monitor mode. 

Runs the appropriate processor and the LOADER. 



MACX1 1 (the PDP-1 1 assembler for the PDP-10) will be recognized as a processor only if the appro- 
priate assembly switch is set. However, this assembly switch setting is not supported. 

"SNOBOL will be recognized as a processor only if the appropriate assembly switch is set. However, 
this assembly switch setting is not supported. 
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Associated Messages 

Refer to Chapter 4 . 

Examples 



_»_LOAD TEST J 
J^ACHO; TES T 
LOADING 

LOADER 2K COrfE 

EX I T 
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Function 



The LOCATE command logically establishes the user's job at a specified station. When the job 
is initiated, the user's logical station corresponds to his physical station. Therefore, this com- 
mand is needed only if the user desires to change his logical station. 



Command Format 



LOCATE nn 

nn = the station number. 

An argument of denotes the central station. A null argument implies the station of 
the user's terminal, i.e., his physical station. 



Characteristics 



The LOCATE command: 



Leaves the terminal in monitor mode. 

Depends on FTREM which is normally absent in the DECsystem-1040. 



Restrictions 



The LOCATE command must specify a station that is currently in contact with the central 
station. ! 



Associated Messages 

Refer to Chapter 4. 

Examples - 



.LOCATF 2 J 

Tloc &J 
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LOGIN command 



Function 



The LOGIN command is used to gain access to the system. This command loads a Monitor 
Support program which accepts the user's LOGIN data . The user types in his project and 
programmer numbers followed by his password. To login successfully, the project and pro- 
grammer numbers and the password typed in by the user must match the project and programmer 
numbers and password stored in the system accounting file (SYS:ACCT.SYS) . 



Command Format 



LOGIN pro j, prog 



proj,prog = the user's project-programmer number. The project and programmer numbers 
may be separated by either a comma or a slash . If a slash is used, the message of the 
day is not output to the user unless the date on the file containing the message 
(NOTICE.TXT) is later than the last time the user logged-in. If this is true, the mes- 
sage is typed only once, whereas, when the comma is used, the message is output 
every time the user logs in . This argument may be typed on the same line as the 
LOGIN command, or on the following line after LOGIN types out the number sign. 



Characteristics 



The LOGIN command: 



Returns the terminal to monitor mode or starts a program running if specified in 

ACCT.SYS entry for pro j, prog. 
Runs the LOGIN program. 
Does not require LOGIN. 



Associated Messages 

Refer to Chapter 4 . 
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LOGIN command (Cont) 



Example 



The following is the procedure used to gain access to the system. 



_.LOGIN 27,235^ 

JOB 21 5S0417A TTY23 



PASSWORD: 



LOGIN types the job number assigned to user (job 
number 21), followed by monitor name, version 
number, and console line number. If the user does 
not type his project-programmer number on the same 
line as the LOGIN command, LOGIN outputs a 
number sign indicating that the user should type in 
his project-programmer number. 

System requests user to type his password. User 
types password followed by carriage return (refer to 
Paragraph 1.4.2.1). To maintain password security, 
the monitor does not echo the password. On terminals 
with local-copy (refer t o DECsystem-10 Monito r 
Calls) , a mask is typed to make the password un- 
readabl e . 



1135 8-JUN-71 THUR 
TYPE SYS:SCHED FOR~ NEXT 
WEEKS SCHEDULE 



If user entries are correct, the system responds with 
time, date, day of the week, the message of the 
day (if any), and a period, indicating readiness to 
accept another command . 
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MAKE command 1 



Function 



The MAKE command runs TECO (Text Editor and Corrector) and creates a new file on the 
disk. If a file already exists with the same name, a warning message is given and the file 
is superseded. Refer to the TECO manual in Notebook 6 of the DECsystem-10 Software 
Notebooks . 



Command Format 



MAKE devrfile.ext [proj,prog] 

dev: = the device or file structure name on which the file is to be created. If omitted, 
DSK: is assumed. 

file.ext = any legal filename and filename extension . The filename is required; the 
filename extension is optional . 

[proj,prog] = the directory in which the file is to be created. If omitted, the user's 
default directory is assumed! . Note that the default directory may be an SFD or some 
other UFD. 



Characteristics 



The MAKE command: 



Places the terminal in user mode. 

Runs the TECO program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 



Associated Messages 

Refer to Chapter 4 . 

Example 

• MAKE TEST3.MAC*) 



This command runs the COMPIL program, which interprets Hie commands before running TECO 
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Function 



The MOUNT command allows the user to request assignment of a device via the operator. 
This command is similar to the ASSIGN command, but, whereas the ASSIGN command operates 
without operator communication, the MOUNT command requests operator interaction when 
necessary. For example, if a Batch user requests a DECtape drive and all drives are in use, 
then the operator can free one for the user, if he wishes. The user can request devices from 
the restricted pool of devices . 

The MOUNT command gives the operator greater control over assignment of devices on the 
system. When a user requests a device via this command, the operator has the option of either 
selecting a specific unit (e.g ., DTA5) or cancelling the request completely (all units of this 
type are in use and the operator does not want to free one for this user) . The operator may 
also mount the media for the requested unit if the media is sufficiently identified (e.g., a 
deck of cards in the card reader or an identified DECtape on a specific drive). 

When the MOUNT command is used to gain access to a file structure, it allows the user to 
specify a particular drive, places the file structure name at the end of the job's search list, 
and waits for completion of operator action, if desired . Each file structure can have an ad- 
ministrative file, QUOTA. SYS, which contains a list of quotas for all users allowed access to 
the structure. When the file structure is mounted, a UFD is created for the user if he has an 
entry in QUOTA. SYS on the file structure. 

The MOUNT command runs the UMOUNT program in the user's core area. UMOUNT scans 
the command string and completes as much of the command as possible without operator inter- 
vention. When operator intervention is required, UMOUNT queues a request to the OMOUNT 
program by writing a command file on the 3,3 disk area. OMOUNT examines these command 
files and interacts with the operator. When the command file is deleted, the operator action 
has been completed. UMOUNT waits for this completion of operator action unless the user 
types a control -C . When a control -C is typed, the user does not receive a message of con- 
firmation, but can later use the /CHECK switch to see if his request is still pending (see 
Exampl es) . 



Command Format 



MOUNT dev: I og-dev /switches (drives) 

dev: = one of the following: (1) a physical device name (e.g., DTA3, CDR, MTA), 
(2) a logical name previously associated with a physical device by either a MOUNT 
or ASSIGN command, or (3) a file structure name (one that is already mounted or 
one whose name appears in STRLST.SYS) . This argument is required. 

(continued on next page) 
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Command Format (cont) 



log-dev = any SIXBIT name that is not the same as dev:. In other words, it may not 

be a physical device name or logical name that is currently being used or has previously 

been used as dev:. This argument is optional. 

switches = The following switches are optional and only enough characters to make the 
switch unique are required. The unique names are underlined below. 



/CHECK 

^IHELP 

/MULTI 

/PAUSE 

AONLY 
/SINGLE 

/VID:nam( 



Check and list pending requests. 

Type this list. 

Multi-access, disk only, complement of /SINGLE, 
default condition. 

Notify the user before sending the message to the 
operator for a request. The user can then abort 
the command if desired. 

Read only, same as /V/LOCK . 

Only this job can access files on the structure 
(single access), file protection is enforced for 
him, disk only. 

A visual identification passed to the operator as a 
comment to assist him in identifying a particular unit 
to mount. The argument can be in one of two forms: 
1) any string of up to 25 characters containing only 
letters, digits, periods, and hyphens, or 2) any 
string of up to 25 characters enclosed in single 
quotes. However, break characters and single 
quotes are not allowed in the string. The naming 
and use of this switch is relevant only to the extent 
that the installation operator knows what it means. 
The PLEASE command should be used for any complex 
procedures or long communications with the opera- 
tor. 



/WENABL 



Write enable for this job, complement of /VVLOCK, 
default condition. 



(continued on next page) 
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Command Format (cont) 



/WLOCK Write locked for this job. This job cannot write on 

this file structure and the monitor will not update 
BAT blocks or the access date. If /SINGLE is 
given, the operator may set hardware write lock 
to ensure that nothing is written. 

(drives) = the physical drives on which the units are to be mounted. A drive argument 
may be used only when mounting file structures. The drives must be in the logical unit 
order within the file structure. Drive names are separated by commas. Leading and 
embedded drives that are not specified must be represented by null names (,,DPA3). 
Unspecified trailing drives may be omitted. Drive names are as follows: 

Blank, null - unspecified. UMOUNT finds one of proper type. 

Two letters - controller class (e.g., DP). 

Three letters - specific controller (e.g., DPA). UMOUNT finds a drive on 
that controller. 

Three letters and one or two digits - specific drive (e.g., DPAO, DPA1). 

The user, by specifying a drive list, may force the packs to be mounted on specific 
drives or controllers. If no drive (or incomplete) specification is given, an available 
drive of the proper type is found. 

Characteristics 

The MOUNT command: 

Places the terminal in user mode. 

Runs the UMOUNT program, thereby destroying the user's core image. 

Depends on FTCCLX and FTMOUN which are normally absent in the DECsystem-1040. 

Associated Messages # 

Refer to Chapter 4. 
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MOUNT command (Court) 



Examples 



^MOUNT PRIVlJ 
PR IV MOUNTED 



Asks the operator to mount the file structure PR1V. 



.MOUNT PAY:<DPA,,DPB)/S 



_.MOUNT MINE: J 
O PERATOR NOTIFIED 
WAITING. .. 



tC 



Requests that the first unit of file structure PAY be 
mounted on Controller A, the second unit on any 
controller, the third unit on controller B, and 
any remaining units on any drives. The structure 
will be single access (i.e., available only to this 
job). 

Mount the file structure MINE. 

The request is queued to the operator. 

UMOUNT is waiting for the request to be completed, 

The user does not wait for confirmation. 



^MOUNT/CHECK^ 



NONE PENDI NG 

M SETSRCJ 

*T 

DSKAjDSKB, PR IV, PAY* MI NEWPENCE 

j£tC 

..MOUNT DTA INPUT 



OPERATOR NOTIFIED 
WAITING. .. 

INPUT (DTA 5) MOUNTED 
.MOUNT INPUT/VID:325 



O PERATOR NOTIFIED 
WA I T I NG . • . 



INPUT (DTA5) MOUNTED 
.MOUNT INPUT OUTPUT 



OUTPUT CDTA5) MOUNTED 



The user wants to know if his request has been 
processed . 

The request has been processed. 

The user wants to know if the file structure is in 

his search list. 

The file structure has been added to his search list. 

The user wants the operator to select a DECtape 
drive and assign it with logical name INPUT. 

The request is queued to the operator. 

UMOUNT is waiting for the request to be completed. 

The operator has selected DTA5. 

The user asks the operator to mount the DECtape 

labeled 325. He may use either DTA5 or INPUT 

to refer to his device. For example, the Batch user 

would use INPUT since he would not know what 

DECtape drive he is assigned. 

The request is queued. 

UMOUNT is waiting for confirmation. 

The mount is successful . 

The user changes the logical name to OUTPUT. 

The logical name INPUT is no longer valid. 

The mount is successful . 
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OPSER program 



Function 



The OPSER program facilitates multiple job control from a single operator terminal by allowing 
the operator to run several jobs called sub jobs from his terminal . The OPSER program acts as 
the supervisor of the various subjobs by allowing monitor level or user level commands to be 
passed to all of the subjobs or to selected subjobs. Output from the various subjobs may be re- 
trieved by OPSER. 

The subjobs of OPSER run on psuedo-TTYs (refer to DECsystem-10 Monitor Calls ) and all 
initializations of the pseudo-TTYs are performed by OPSER. The operator needs only to pro- 
vide the subjob name, either an OPSER-provided subjob number or an operator-assigned name. 
System programs that require a dedicated terminal can be run as subjobs of OPSER. By running 
system jobs on pseudo-TTYs, OPSER is able to maintain an I/O link between the running jobs 
and the operator. In addition, the output from the various subjobs is concentrated on one 
terminal instead of many, as was the case when each system program required its own terminal . 

Refer to the MPB Operator's Manual in the DECsystem^-lO Software Notebooks for complete 
information on OPSER. 



Command Format 



R OPSER 



OPSER signifies its readiness to process commands by typing an asterisk if no subjobs 
are in use or subjobs are in a wait for an operator actibn. OPSER responds with an 
exclamation point when a subjob is running . Commands may be entered whenever 
OPSER is operating . Each command is preceded by a colon and must be typed to 
sufficient length to make it unique. 

OPSER Commands 



:AUTO/hh:mm filespec 



rBATMAX n 
:BATMIN n 



Process the specified file as an automatic startup 
file. The file is terminated by an end-of-file or 
the typing of a line on the console by the operator. 
This is the normal way that the standard subjobs are 
started by the operator. The time argument is op- 
tional; when it is given, the AUTO file is run at 
the specified time. 

Specify the maximum number of batch jobs allowed. 

Specify the minimum number of batch jobs guaran- 
teed . 



(continued on next page) 



Not yet implemented, 
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OPSER program (Cont) 



Command Format (cont) 

:CLOSE 
:CURRENT 



: DAYTIME 
rDEFINE xxx=n 



:DEVICE nam:log:n 



:ERROR n 



:EXIT 



FREE 
HELP 
JCONTn 
KJOB, n,m,p 

:KILL n,m,p 

:KSYS hhmm 

: LOG IN proj / prog 

rMSGLVL 0. 



Close the disk log file without opening a new one. 

Type the number of the current sub job (the last 
one typed into) . Output from another subjob does 
not affect current subjob. 

Obtain the current date and time. 

Associate the symbol xxx as the mnemonic for sub- 
job number n . The symbol B is reserved for the sub- 
job running BATCON. 

Assign the device with the physical name nam and 
logical name log to subjob n. The logical name is 
optional but a null field must be typed if the name 
is omitted, e.g., :DEVICE CDR::3. 

Report only error messages (that is, ignore nonerror 
messages from subjob n). Message reporting is re- 
sumed with the rREVIVE command. 

Exit to the monitor if no sub jobs are in use; other- 
wise give a list of those that are running . This 
should be used instead of tC, since EXIT does not 
return the job to monitor mode if there are any 
active subjobs . 

Type the first free subjob number. 

Type a text which briefly explains the commands. 

Continue the specified stopped job. 

Kill the specified subjobs saving all files. Causes 
/Z:0 to be included to KJOB so spooled files are 
not queued . 

Kill the specified subjobs. This is identical to 
:KJOB. 

Stop all timesharing at the time specified by hhmm. 

Login a new subjob. If no project-programmer num- 
ber is typed, assume OPSER's project-programmer 
number. 

Cause the response to the :WHAT command to in- 
clude the JOBSTS bits. 

(continued on next page) 
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Not yet implemented, 



OPSER program (Cont) 



Command Format (cont) 

:MSGLVL 1 

:QUEUE <line> 



:RESOURCES 
:RESTRICT dev 1 

:REVIVE n 
:SEND <line> 
:SETa 



:SET RUN CPUn 

:SET RUN NO CPUn 

:SILENCE n, 
:SLOGIN proj,prog 



Cause the response to :WHAT command to eliminate 
the JOBSTS bits. 

Initiate the first free subjob and send the typed-in 
line to the system queue manager. 

.Type the list of the available system resources. 

Make the specified device a restricted device (i.e., 
one that is assignable only by a privileged job or 
the MOUNT program). 

Resume normal echoing of output from subjob n. 

Simulate the SEND monitor command. 

Simulate a SET monitor command. Valid SET mon- 
itor commands are SET CORMAX, SET CORMIN, 
SET DATE, SET DAYTIME, SET LOGMAX, SET 
OPR TTY, SET SCHED, and SET TTY. 

Add CPUn to the pool of CPUs to be used for run- 
ning jobs. 

Remove CPUn from the pool of CPUs to be used for 
running jobs. 

Ignore all output from subjob n. 

LOGIN one subjob but suppress its response. If proj, 
prog is omitted, OPSER uses its own. 



:STOP n 

:SYSTAT xx 
:TLOG filespec 

:TTYTST 



Put the specified subjob in monitor mode. This is 
equivalent to inputting two control-C's in inter- 
active mode. 

Run SYSTAT with optional argument xx over the first 
free subjob. 

Create a disk log file with the specified name. If 
the file already exists, a message is typed to deter- 
mine whether the existing file should be superseded. 
If not, the file is appended to the existing one. 
Default for filespec is OPSER.LOG. 

Test this terminal by typing all the ASCII characters 
between octal 40 and 174, inclusive. 

(continued on next page) 
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OPSER program (Cant) 



Command Format (cont) 



:UNRESTRICT dev 



:WHAT n/ m /P 



Make the specified device a unrestricted device 
(i.e., one that is assignable by both privileged and 
non-priv? ieged jobs). 

Type the status of the specified subjobs on the term- 
inal. The status includes a SYSTAT with the time, 
the time of the last input and the last output, and a 
linear listing of the JOBSTS bits. 

When a subjob number or name is required in a command string, the subjob may be 
specified in one of four ways. It can be omitted, in which case the last subjob typed 
into is used. The mnemonic ALL may be used, in which case all active subjobs are 
implied. A decimal number can be used from zero to the limit OPSER is generated for. 
Finally, a mnemonic can be assigned to the subjob with the :DEFINE command. 



Examples 



**AUT0 CTY.ATO 



To start an automatic startup file. 



iMSGLVL 
:TL0G 
:SL0G 

: DEFINE DAE= 
DAE-R DAEMON 
tiJl^QG 

: DEFINE M = 
M-rt MOUNT 
M -START 
:SLQG 

: DEFINE L= 
L-ri LPTSPL 
L-START 
:SL0G 

:DEFINE B= 
B-MJOB 5 
B-R BATCON 
B-STAKT 



An example of an automatic startup file. 



Not yet implemented. 
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PJOB command 



Function 



The PJOB command causes the monitor to respond with the job to which the user's terminal is 
attached . 



Command Format 
PJOB 

Characteristics 

The PJOB command: 

Leaves the terminal in monitor mode. 

Associated Messages 

Refer to Chapter 4. 

Example 

•PJOB^ 

T 
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PLEASE command 



Function 



The PLEASE command allows the user non-conflicting two-way communication with the desig- 
nated station operator. 

Command Format 

PLEASE dev: prog! text 

dey = any terminal not assigned to a job (i.e., is not a job's controlling terminal) with 
which the user wishes to communicate, including: 

a. TTYn: directs the text to a specific terminal unit. The default is TTYO. 

b. OPRnn: directs the text to the operator's terminal station nn. 
c (null argument) directs the text to TTYO atthe central station. 

prog! = the name of the system program to be run automatically when the message is 
completed. This argument may appear before or after the device argument and must be 
concluded with an exclamation point. If PLEASE is entered at the CCL entry point, it 
reads file nnnPLS.TMP. This file is sent to the designated device. After the operator 
terminates the request, the specified program will be run at its CCL entry point. 
Neither the dev: or prog! argument can be used from a Batch control file. 

text = the user's message. The argument is required. Characters are not transmitted 
until the RETURN, vertical tab, or form feed key is depressed, at which point the 
entire line is transmitted. 

When the user depresses the RETURN, vertical tab, or form feed key, a message inform- 

Iing the operator of the caller's station number, proj-prog number or user's name if 
monitor job tables are available, and text message is printed on dev:. An ESCAPE or 
control-C on either the user's terminal or dev: causes communication to terminate and 
the user's TTY to be left in monitor mode. Note that when the line terminates with an 
I ESCAPE, the line is typed but the operator response is not waited for. Messages may 

be typed in both directions without retyping the command. 

Characteristics 

The PLEASE command: 

Places the terminal in user mode until ESCAPE is typed. 

Runs a system program except when used with Batch. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 
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PLEASE command (Cont) 



Restrictions 

For Batch users, the PLEASE command is trapped by the Batch Controller and only PLEASE text 
is allowed. It can be used to request operator action while in the Batch mode. The line of 
text can only be one line terminated with an ESCAPE. 

Associated Messages 

Refer to Chapter 4. 



Example 



.PLEASE TELL ME WHEN DTA3 WILL BE FREE^ 

OPERATOR HAS BEEN NOTIFIED 

IN HALF AN HOUR 

THANKS 

tC 
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PLOT command 



Function 

The PLOT command is used to place entries in the plotter output queue. This command is 
equivalent to the following form of the QUEUE command: 

QUEUE PLTrjobname = list of input specifications 

Command Format 

PLOT jobname = list of input specifications 

jobname = name of the job being entered into the queue. The default is the name of 
the first file in the request, not the name of the first file given. These differ when the 
first file given does not yet exist. 

input specifications = a single file specification or a string of file specifications, 
separated by commas, for tie disk files being processed. A file specification Is in the 
form dev:file.ext[proj, prog]. 

dev: = any file structure to which PLTSPL will have access; the default is DSK:. 

file.ext = names of the files. The filename is optional. The default for the 
first filename is *, the default for subsequent files is the last filename used. 
The extension can be omitted; the default is .PLT. 

[p r °i/Prog] = a directory to which the user has access; the user's directory is 
assumed if none is specified. 

If no arguments are given with the command (i.e., only the command name is given), 
the entries for all jobs of all users are output. The asterisk convention can be used 
for the input specifications. Switches that aid in constructing the queue entry can 
appear as part of the input specifications. These switches are divided into three cate- 
gories: 

1. Queue-operation - Only one of these switches can be placed in the com- 
mand string because they define the type of queue request. The switch 
used can appear anywhere in the command string. 

2. General - Each switch in this category can appear only once in the com- 
mand string because they affect the entire request. The switch used can 
appear anywhere in the command string. 

(continued on next page) 
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PLOT command (Cont) 



Command Format (cont) 



3. File control - Any number of these switches can appear in the command 
string because they are specific to individual files within the request. The 
switch used must be adjacent to the file to which it applies. If the switch 
precedes the filename, it becomes the default for subsequent files. 



The following switches can be used with the PLOT command: 

Switch Explanation 

/AFTERrtt Process the request after the specified time; it is either 

in the form of hhmm (time of day) or +hhmm (time later 
than the current time). The resulting AFTER time must 
be less than the DEADLINE time. If the switch, or the 
value of the switch, is omitted, no AFTER constraints 
are assumed. 

/BEFORE:t Queue only the files with creation dates before t where 

t is in the form dd-mmm-yy hhmm. 

/BEGINrn Start the output after n feet. The default is to start 

output at the beginning. 

/COPIESrn Repeat the output the specified number of times, n 

must be less than 64. If more than 63 copies are 
needed, two separate requests must be made. If the 
switch is omitted, single copies are output. 

/CREATE Make a new entry into the plotter output queue. This 

switch is the default for the queue-operation switches. 

/DEADLINE:tt Process the request before the specified time; tt is 

either in the form hhmm (time of day) or +hhmm (time 
later than the current time). The resulting DEADLINE 
time must be greater than the AFTER time. If the 
switch, or the value of the switch, is omitted, no 
DEADLINE constraints are assumed. 



Category 



General 



General 

File Control 
File Control 

Queue Operation 
General 



/DISPOSE:DELETE 



Delete the file after spooling. 



File Control 



/DISPOSE rPRESERVE 



Save the file after spooling. This is the default for all 
files except files with extensions . LST, .TMP, and, if 
the protection is Oxx, .PLT. 



File Control 



(continued on next page) 
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PLOT command (Cont) 



Command Format (cont) 
Switch 



/DISPOSE:RENAME 



Explanation 

Rename the file from the specified directory immediately, 
remove it from the logged-out quota and delete it after 
spooling. This is the default for files with extensions 
.LST, .TMP, and if the protection is Oxx, „PLT. 



Category 
File Control 



/F 
/FORMS :a 

/KILL 



/ LIMIT :n 
/LIST 



List the entires in the plotter queue, but do not update 
the queues. Therefore; the list may not be an up-to-date 
listing but the listing will be faster than with /LIST. 

Place the output on the specified form. The argument 
to the switch must be six alphabetic characters. The de- 
fault is that normal forms are used. 

Remove the specified entry from the plotter queue. This 
switch can be used For deleting a previously submitted 
request as long as the request has not been started by 
the spoolers. 

Limit the output to the specified number of pages. 

List the entries in the plotter queue; if the switch, along 
with all other switches, is omitted, all entries for all jobs 
of all users are listed. 



Queue Operation 



General 



Queue Operation 



General 
General 



/MODIFY 



/NEW 



Alter the specified parameters in the job. This switch 
requires that the user have access rights to the job. It 
can be used for altering a previously submitted request 
as long as the request has not been started by the spool- 
ers. 

Accept the request even if the file does not yet exist. 



Queue Operation 



File Control 



(continued on next page) 
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Command Format (cont) 

Switch 
/NOTE:a 
/NULL 

/OKNONE 

/PHYSICAL 

/PLOT:ASCII 

/PLOTrBINARY 

/PLOTrlMAGE 

/PRIORITY :n 

/PROTECT:nnn 
/REMOVE 

/SEQ:n 
/SINCE* 



y , Explanation Category 

Plot the specified text (a) in the output. File Control 

Accept the request even if there is nothing in the re- General 

quest. No error message is given. 

Do not output message if no files match the wildcard File Control 

construction. This is assumed at KJOB time. 

Suppress logical device name assignments for the device File Control 
specified. 

Plot the fi le in ASCII mode. If the /PLOT: switch is Fi le Control 

omitted, the file is plotted in the data mode specified in 
the file. 

Plot the file in binary mode. If the /PLOT: switch is File Control 

omitted, the file is plotted in the data mode specified 
in the file. 

Plot the file in image mode. If /PLOT: switch is omit- File Control 

ted, the file is plotted in the data mode specified in the 

file. 

Assign the specified external priority (n=0 to 62) to the General 

request. The larger the number, the greater priority the 
job has. The default is 10 if no switch is given and 20 
if the switch is specified without a value. 

Assign the protection nnn (octal) to the job. If the General 

switch or the value of the switch is omitted, the standard 
protection is assumed. 

Remove the file from the queue. This switch is valid File Control 

only with /MODIFY and can be used to remove a pre- 
viously submitted file as long as the spoolers have not 
started processing the request. 

Specify a sequence number to help in identifying a General 

request to be modified or deleted. 

Queue only the files with creation dates after the speci- General 
fied time t where t is in the form dd-mmm-yy hhmm. 

(continued on next page) 
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PLOT command (Cont) 



Command Format (cont) 



Switc h 
/START :n 

/STRS 

/UN PRESERVED 

Characteristics 



Explanation 

Start on the nth line of the file. If the switch, or the 
value of the switch is omitted, the first line is assumed. 

Search for the file on all file structures in the search list 
and take each occurrence. The default is to take just 
the first occurrence. 

Output the files only if they are not preserved (i.e., 
the first digit of the protection code is 0). This 
switch avoids redundant plotting. 



The PLOT command: 



Category 
File Control 

File Control 
General 



Leaves the terminal in monitor mode. 

Runs the QUEUE program, thereby destroying the user's core image. 

Depends on FTQCOM which is normally absent in the DECsystem-1040. 



Associated M essages 

Refer to Chapter 4. 



Examp les 



^PLOT *.PLT/FOHMS:PLAINJ 



Cause all files with the extension PLT in the user's 
area to be plotted. Because these are spooled files 
(i.e., have the extension .PLT), the files are 
renamed out of the user's area immediately, and 
deleted after plotting. The operator is asked to 
put PLAIN paper on the plotter. 
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PRESERVE command 1 



Function 



The PRESERVE command renames the specified files with the standard protection inclusively | 
ORed with 100 (usually 155 or 157). The files are then preserved and KJOB will not delete 
them unless requested to. This command has the same action as the P argument to the KJOB 
command when individually determining what to do with each file. 



Command Format 



PRESERVE ft lei .ext,file2.exf,file3.ext,. . . 

The full wildcard construction can be used for either the filename or the extension. 



Characteristics 



The PRESERVE command: 

Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 



Associated Messages 

Refer to Chapter 4. 

Example 

.PRESERVE TEST. MAC,) 

TpRE PROG* COLE. F4, NAME. *J 



This command runs the COMPIL program, which interprets the command before running PIP. 

Version 20 COMPIL 
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I PRINT command 



Function 

The PRINT command is used to place entries into the line printer output queue. This command 
is equivalent to the following form of the QUEUE command: 

QUEUE LPTrjobname = list of input specifications 

Command Format 

PRINT jobname : = list of input specifications 

jobname = name of the job being entered into the queue. The default is the name of 
the first file in the request, not the name of the first file given. These differ when the 
first file given does not yet exist. 

input specifications = a single file specification or a string of file specifications, sepa- 
rated by commas, for the disk files being processed. A file specification is in the form 
dev :f i le . ext [proj , prog] . 

dev: = any file structure to which LPTSPL will have access; the default is DSK:. 

file. ext = names of the files. The filename is optional. The default for the 
first filename is *, the default for subsequent files in the last filename used. 
The extension can be omitted; the default is . LPT. 

[pro{,prog] = a directory to which the user has access; the user's directory is 
assumed if none is specified. 

If no arguments are given with the command (i.e., only the command name is given), 
the entries for "all jobs for all users are output. 

The asterisk convention can be used for the input specifications. Switches that aid in 
constructing the queue entry can appear as part of the input specifications. These 
switches are divided into three categories: 

1. Queue-operation - Only one of these switches can be placed in the com- 
mand string because they define the type of queue request. The switch 
used can appear anywhere in the command string. 

2. General - Each switch in this category can appear only once in the com- 
mand string because they affect the entire request. The switch used can 
appear anywhere in the command string. 

(continued on next page) 
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Command Format (cont) 



File control - Any number of these switches can appear in the command 
string because they are specific to individual files within the request. The 
switch used must be adjacent to the fi le to which it appl.es. If the sw.tch 
precedes the filename, it becomes the default for subsequent files. 



Switch 
/AFTER :tt 



/BEFORE:t 

/BEGIN :n 
/COPIESrn 



/CREATE 
/DEADLINES 



The following switches can be used with the PRINT command: 

Explanation 

Process the request after the specified time; tt is either 
in the form of hhmm (time of day) or +hhmm (time later 
than the current time). The resulting AFTER time must . 
be less than the DEADLINE time. If the switch, or the 
value of the switch, is omitted, no AFTER constraints 
are assumed. 

Queue only the files with a creation date before time t, 
where t is in the form dd-mmm-yy hhmm. If this switch 
is omitted, no BEFORE constraints are assumed. 

Start the output on the nth page. The default is to begin 

output on the first page. 

Repeat the output the specified number of times, n must 

be less than 64. If more than 63 copies are needed, two 

separate requests must be made. If this switch is omitted, 

one copy is given. 

Make a new entry into the line printer output queue. 

This switch is the default for the queue-operation 

switches. 



Process the request before the specified time; tt is either 
in the form hhmm (time of day) or +hhmm (time later than 
the current time). The resulting DEADLINE time must 
be greater than the AFTER time. If the switch, or the 
value of the switch, is omitted, no DEADLINE con- 
straints are assumed. 



/DISPOSE:DELETE Delete the file after spooling. 



/DISPOSE PRESERVE 



Save the file after spooling. This is the default for all 
fi les except fi les with extensions of . LST, .TMP, and, 
if the protection is Oxx, .LPT. 



Category 



General 



General 



File Control 



File Control 



Queue Operation 



General 



File Control 



File Control 



(continued on next page) 
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PRINT command (Cont) 



Command Format (cont) 



Switch 
/DlSPOSErRENAME 



/FILErASCII 

/FILErCOBOL 
/FILE.-FORTRAN 

/FORMS :a 

/HEADER. -0 or 1 
/KILL 

/UMlTm 
'/LIST 

/LOG 



Explanation 



Rename the file from the specified directory immediately 
remove ,t from the logged-out quota, and delete it after 

T<°T 9 ;Jo IS ^ defQult f ° r fi,es with extensions 
L5I, . IMP, and, it the protection is Oxx, .LPT. 

Ust the entries in the line printer queue, but do not up- 
date the queues. Therefore, the list may not be an up- 
to-date listing but the listing will be faster than with 

Indicate that the input file format is to be interpreted 
as ASCII text. This is assumed for all files with ex- 
tensions other than .DAT. 

^ d ro R e nI ,a <; t TV e r; npUt f?le fom,af fs to be '"'erpreted 
as COBOL SIX BIT text. 

inLwAK^c? 6 InpUt fHe format !s *> be Interpreted 
FORTRAN ASCII text (obeys FORTRAN carriage control 
characters). This is assumed for files with the extension 

Place the output on the specified form. The argument to 
the switch must be six alphabetic characters. The default 
is that normal forms are used. 

Output block headers at the beginning of the file, if 1 
(default). Do not output headers, if 0. 

Remove the specified entry from the Batch input queue 
This sw.tch can be used for deleting a previously sub- ' 
m.tted request as long as the request has not been started 
by the spooler. 

Limit the output to the specified number of pages. 

List ^e entries in the line printer queue; if the switch, 
along w.th all other switches, is omitted, all entries 
tpr all jobs of all users are listed. 

Define the file that the spoolers will use to record their 
process. The default is jobname . LOG. 



Category 
File Control 



Queue Operation 

File Control 

File Control 
File Control 

General 

File Control 
Queue Operation 

General 

Queue Operation 

File Control 



(continued on next page) 
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PRINT command (Cont) 



Command Format (cont) 



Switch 
/MODIFY 

/NEW 

/NOTE:a 

/NULL 

/OKBINARY 

/OKNONE 

/PHYSICAL 

/PRINTrARROW 

/PRINT:ASCII 
/PRINT .-OCTAL 
/PRINTrSUPPRESS 

/PRIORITY :n 

/PROTECTrnnn 



Explanation 

Alter the specified parameters in the job. This switch 
requires that the user have access rights to the job. It 
can be used for altering a previously submitted request 
as long as the request has not been started by the spooler. 

Accept the request even if the file does not yet exist. 

Print the specified text (a) in the output. 

Accept the request even if there is nothing in the 
request. No error message is given. 

Print files whose extensions imply binary information. 
Normally files with extensions .SAV, .SHR, .LOW, 
. REL, and .HGH will not appear in the print queue. 

Do not output message if no files match the wildcard 
construction. This is assumed at K JOB time. 

Suppress logical device name assignments for the device 
specified. 

Convert all control characters to up-arrow format except 
01 1-015 and 020-024. This is the default. 

Send the file to the line printer with no changes. 

Perform an octal dump of the file. 

Suppress all carriage-control characters except for 
ASCII code characters LF and CR; this switch implies 
the use of the /PRINT :ARROW and is equivalent to 
the operator command to the spooler (SUPPRESS). 

Assign the specified external priority (n=0 to 62) to the 
request. The larger the number, the greater priority 
the job has. The default is 10 if no switch is given and 
20 if the switch is specified without a value. 

Assign the protection nnn (octal) to the job. If'the 
switch, or the value of the switch, is omitted, the stan- 
dard protection is assumed. 



Category 
Queue Operati on 

File Control 
File Control 
General 

File Control 

File Control 

File Control 

File Control 

File Control 
File Control 
File Control 

General 

General 
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PRINT command (Cent) 



Command Format (cont) 



Switch 
/REMOVE 

/REPORT :code 

/SEQ:n 

/SI NICE :t 

/SPACINGrDOUBLE 
/SPACINGrSINGLE 

/SPACINGrTRIPLE 
/START :n 

/STRS 

/UN PRESERVED 

Characteristics 



Explanation Category 

Remove the file from the queue. This switch is valid only File Control 
with /MODIFY and can be used to remove a previously 
submitted f? le as long as the spooler has not started pro- 
cessing the request. 

Print the specified report within a COBOL report file. File Control 

Code can be up to 12 characters in length. 

Specify a sequence number to help in identifying a re- General 

quest to be modified or deleted. 

Queue only the files with creation dates after the speci- General 
fied time t where t is in the form dd-mmm-yy hhmm. 

Double-space the output lines. File Control 

Single-space the output lines. This is the default if no File Control 

/SPACING switch is used. 

Triple-space the output lines. File Control 

Start on the nth line of the file. If the switch, or the File Control 

value of the switch, is omitted, the first line is assumed. 

Search for the file on all file structures in the search list File Control 
and take each occurrence. The default is to take just 
the first occurrence. 

Output the file:; only if they are not preserved (i.e., the General 
first digit of the protection code is 0). This switch 
avoids redundant printing. 



The PRINT command: 



Leaves the terminal in monitor mode. 

Runs the QUEUE program, thereby destroying the user's core image. 

Depends on FTQCOM which is normally absent in the DECsystem-1040. 



Associated Messages 

Refer to Chapter 4. 
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PRINT command (Cont) 



Examples 

.PRINT NOTICE.TXT^ Print the file DSK:N OTICE.TXT. 

.PRINT SYSTAT.SCM/DISPrREN/COP^J 

Print two copies of the file DSKrSYSTAT.SCM from 
the user's default area. Rename the file out of the 
user's area immediately and delete it after spooling. 

._PRINT *• TXT/HEAD :0 /FORMS :2PARTj 

Print all files in the user's area which have the 

extension .TXT. Do not print file headers between 

the files. Print the files on forms known to the 

operator as 2 PART. 

• PRINT /SEQ:356/KILL^ Remove the request with sequence number 356 from 

the LPT queue. This is accepted only if the spooler 
has not started processing the request. 

.PRINT LOADER. SAV/OKB I NARY /PR I NT! SUPPRESS J 

Print a file known to be a binary file and suppress 
all carriage control characters except CR and LF. 

.PRINT PRGMACREL/PRINT :OCTAL^ Print an octal dump of the file PRGMAC.REL. 
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PROTECT command 1 



Function 



The PROTECT command renames the specified files with the requested protection. The action 
of this command is similar to the R switch in PIP. 

The protection of a file is indicated by three octal digits. Each digit represents a particular 
class of user. The first digit represents the owner of the file, the second represents users with 
the same project number of the owner, and the third represents all of the other users. Each 
number in the three digit code can be one of the following: 

7 No access privileges 

6 Execute the file only 

5 Read and execute the f i le 

4 Append, read, and execute the fi le 

3 Update, append, read, and execute the f ? le 

2 Write, update, append, read, and execute the fi le 

I Rename, write, update, append, read, and execute the fi le 

Change protection, rename, write, update, append, read, and execute the 
file. 

The standard protection is normally 057 which means the owner has all privileges (0), users in 
the owner's project can read and execute the file (5), and all other users cannot access the file 
{/). However, the system standard may be changed by the individual installations. 



Command Format 



PROTECT fi lei <nnn>, file2 <nnr>, fi Ie3 <nnn>, . . . 

The protection can be specified before the filename in which case it is the default for 
subsequent files until changed. The full wildcard construction can be used for either 
the filename or the extension. 



Characteristics 



The PROTECT command: 

Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 



This command runs the COMPIL program, which interprets the command before running PIP. 
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PROTECT command (Cont) 



Associated Messages 



Refer to Chapter 4. 



Examples 



^PROTECT F0RM.*<157>^) 

^PRO MAIN.MAC<123>, <456>EQU I L .CBL., ADD . ALGJ 
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QUEUE comimand 



Function 



The QUEUE command allows the user to make entries in several system queues - the input 
queue for the Batch system, and the output spooling queues for the line printer, the card punch, 
the paper-tape punch, and the plotter. The QUEUE command also provides the means of ob- 
taining listings of the entries in the queues. 



Command Formats 



I. QUEUE INP: jobname = control file specification, log file specification 
To make an entry in the Batch input queue, INP:. 

2. QUEUE output queue name: jobname = list of input specifications 

To make an entry in an output spooling queue. 

3. QUEUE listing file specifications/LIST = list of queue names 

To obtain a listing of the entries in a queue. 

4. The following six commands can be substituted for the various formats of the QUEUE 
command: 

a. CPUNCH jobname = list of input specifications 
equivalent to QUEUE CDP: jobname = list 

b. PLOT jobname = list of input specifications 
equivalent to QUEUE PLT: jobname = list 

c. PRINT jobname = list of input specifications 
equivalent to QUEUE LPT: jobname = list 

d. PUNCH jobname = list of input specifications 
equivalent to QUEUE PTP: jobname = list 

e. SUBMIT jobname = control file name, log file name 
equivalent to QUEUE INP: jobname = control file, log file 

f. TPUNCH jobname - list of input specifications 
equivalent to QUEUE PTP: jobname = list 

Queue names are taken from the following list: 

INP: (I:) Batch input queue 

LPT: (L:) line printer output queue, default condition 

CDP: (C:) card punch output queue 

PTP: (PT:) paper-tape punch output queue 

PLT: (PL:) plotter output queue 



The PUNCH command can be redefined by the installation to be equivalent to 
QUEUE CDP: jobname = list. 
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QUEUE command (Cont) 



Command Formats (cont) 

Control file specification is the file specification, plus switches and keyword parameters, 
for the control file being submitted to the Batch input queue. This file can be on an/ file 
structure that the user has access to; the default is DSK:. The filename is required, but the 
extension can be omitted; the default is .CTL. The asterisk construction is legal for the 
filename or extension. 

Log file specification is the file specification for the file that is to be used to record actions 
taken during the execution of the control file. This file can be on any file structure in which 
the user can write. The default is the same file structure in which the control file resides. 
If the filename is missing, the log file is given the same name as the control file. If the 
extension is omitted, it is .LOG,, 

Jobname is the name of the job being entered into the queue. The default jobname is the name 
of the first file in the request not the first file given. These names are different when the first 
file given does not yet exist. 

Input specifications are the file specifications for the disk files to be processed, and the various 
switches and keyword parameters that aid in constructing the queue entry. The files can be on 
any file structure that the queue processor has access to; the default is DSK:. The files can be 
in any directory, provided that the user has read-access to them; the default is the user's direc- 
tory. The filename is optional; the default is * for the first filename. The default for subse- 
quent filenames is the last filename used. . Note that the asterisk construction is legal only in 
the input specifications. The extension can be omitted because each queue has a default ex- 
tension for the files to be processed. These default extensions are: 

.CTL - Batch input queue 

.LPT - line printer queue 

.CDP - card punch queue 

.PTP - paper-tape punch queue 

.PLT - plotter queue 

The listing file specification is the description of the listing file. The default for the listing 
file destination is TTY unless a name is specified. If no queue names are specified, all queues 
for all the jobs of all users are listed. 

Switches - Three categories of switches are provided. The first category contains the switches 
that define the operation; the second contains the switches that can appear only once because 
they affect the entire request; the third contains the switches specific to each file. In general, 
switches that precede the filename become the default for all succeeding files. This is true 
also for a device name, an extension, or a directory name that precedes a filename. 

Queue-Operation Switches - Only one of this type of switch can be placed in a command 
string, because these switches define the type of queue request. This switch may appear any- 
where in the command string. 
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QUEUE command (Cont) 



Command Formats (cont) 



General Queue Switches - Each of these switches can appear only once in a command string. 
They affect the entire request, generally in terms of scheduling. These switches can appear 
anywhere in the command string. 



File-Control Switches - These switches affect the individual files in a request and must be 
adjacent to the filename in the command string. In order to change the defaults for the rest 
of the files, however, these switches must appear before a filename. 

In the table of switches below, the following conventions have been used: 



ALL 



Switches that can appear for both the Batch input queue and the output 
queues. 



INPUT - Switches thai can appear only for the Batch input queue. 

LIST - Switches that can appear only for the listing file specification. 

OUTPUT - Switches that can appear only for the output queues. 



Switch 



/AFTER :t 



/BE FORE :t 



/BEGIN 



/CARDS :n 



M € ! 



■ taning 



Process the request after the speci- 
fied time, t is either in the form 
hhmm (time of day) or +hhmm (time 
later than the current time). The re- 
sulting AFTER time must be less than 
the DEADLINE time. If the switch, 
or the value of the switch, is omitted, 
no AFTER constraints are assumed. 

Queue only the files with creation 
dates before time t where t = dd- 
mmm-yy hhmm. 

Start the output on the nth page, 
card, or foot. The default is to 
begin output on the first unit. 

Use n (decimal) as the maximum num- 
ber of cards that can be punched by 
the job. If the switch is omitted, no 
cards are punched. If the switch is 
given with no value, 2000 cards is 
assumed as the maximum. 



Category 



Qt 



General 



ALL 



General 



File Control 



Genera I 



OUTPUT 



OUTPUT 



INPUT 
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QUEUE command (Cont) 



Command Formats (cont) 



Switch 
/CHARGE^ 1 

/COPIES :n 
/CORE:n 



/CREATE 
/DEADLINE* 



/DEFER 



Meaning 

Charge the run to the specified ac- 
count. 

Repeat the output the specified num- 
ber of times (n must be less than 64). 
The default is one copy. If more than 
63 copies are desired, two requests 
must be made. 

Use n (in decimal K) as the maximum 
amount of core memory that the job 
can use. If the switch is omitted, 
the maximum of 25K is assumed; if 
the value of the switch is omitted, 
a maximum of 40K is assumed. 

Make a new entry in the specified 
queue. This switch is the default 
for the queue-operation switches. 

Process the request before the speci- 
fied time, t is either in the form 
hhmm (time of .day) or +hhmm (time 
later than the current time). The 
resulting DEADLINE time must be 
greater than the /AFTER time. 
If the switch, or the value of the 
switch is omitted, no DEADLINE 
constraints are assumed. 

Make a new entry in the specified 
queue, but the request is deferred 
until LOGOUT. 



Category 



Qi 



General 



File Control 



ALL 



OUTPUT 



General 



INPUT 



Queue Operation ALL 



General 



ALL 



Queue Operation ALL 



Not yet implemented. 
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QUEUE command (Cont) 



Command Formats (cont) 



Switch 
/DEPEND:n 



Meaning 

Specifies the initial value of the 
dependency count in decimal. When 
used with /MODIFY, this switch 
changes the dependency count of 
another job. If n is a signed num- 
ber (+ or -), that number is added 
to or subtracted from the dependent 
job's count. If n is not a signed 
number, the dependent job's count 
is changed to n. If this switch is 
omitted, no dependency is 
assumed. 



Category 
Genera I 



Quei 



INPUT 



/DISPOSErDELETE Delete the file after spooling. 



/DISPOSE PRESERVE 



/DISPOSE:RENAME 



Save the file after spooling. This 
is the default for files with exten- 
sions of . LST, .TMP, and if pro- 
tection is Oxx, .CDP, .LPT, .PLT, 
.PTP. 

Rename the file from the specified 
directory immediately, remove it 
from the logged-out quota, and 
delete it after spooling. This is 
the default for files with exten- 
sions of . LST, .TMP, and if pro- 
tection is Oxx, .CDP, .LPT, 
.PLT, .PTP. 



File Control 
File Control 



ALL 
ALL 



Fife Control 



ALL 



/F 



/FEET:n 



List the entries in the queue, but 
do not update the queues. There- 
fore, the list may not be an up-to- 
date listing of the queues but the 
listing will be faster than with 
/LIST. 

Use n (in decimal) as the maximum 
number of feet of paper tape that 
the job can punch. If the switch is 
omitted, no paper tape is punched. 
If the value is omitted, the default is 
10*B+20 feet, where B is the num- 
ber of blocks in the request. 



Queue Operation LIST 



General 



INPUT 
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Command Formats (cont) 



Switch 
/FILErASCII 

/FILE:COBOL 

/FILE:ELEVEN 
/FILE:FORTRAN 



/FORMS :a 



/HEADER :0 or 1 
/HELP 

/KILL 



Meaning 

Specify that the input file format 
is to be interpreted as ASCII text. 
This is assumed for all files with 
extensions other than .DAT. 

Specify that the input file format 
is to be interpreted as COBOL 
SIX BIT text. 

Specify that the input file format 
is to be interpreted as binary format. 

Specify that the input file format 
is to be interpreted as FORTRAN 
ASCII text (obeys FORTRAN 
carriage control characters). This 
is assumed for files with an 
extension of . DAT. 

Place the output on the named forms. 
The argument to the switch must be 
six alphabetic characters. Normal 
forms (14 x 1 1 ) are used if this 
switch is omitted. Narrow forms 
are 8-1/2 x 11. 

Output block headers at begin- 
ning of the file if 1 (default); do 
not output headers if 0. 

Print a message giving the general 
format of the command string and ex- 
plains the dialogue that is entered 
if the user needs additional help. 

Remove the specified entry, from the 
specified queue. This switch re- 
quires an output specification; it 
does not default to LPT:* The 
/KILL switch can be used for delet- 
ing a previously submitted request 
as long as the request has not been 
started. 



Category 
File Control 

File Control 

File Control 
File Control 



Queues 
OUTPUT 

OUTPUT 

OUTPUT 
OUTPUT 



General 



OUTPUT 



File Control 



OUTPUT 



Queue Operation ALL 
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QUEUE command (Cont) 



Command Formats (cont) 



Switch 



/LIMIT :n 
/LIST 

/LOG 
/MODIFY 



/NEW 

/NOT Era 
/NULL 

/OKBINARY 
/OKNONE 



Me 



aning 



Limit the output to the specified 
number of pages, cards, feet, or 
minutes. 

List the specified entries in the 
queue; the default entries are those 
for queues for all the jobs of all 
users. 

Define the file that the spoolers will 
use to record their output. The de- 
fault is jobname. LOG. 

Alter the specified parameters in the 
specified Jobs; this switch requires 
that the user have access rights to the 
job. It also requires a queue name; it 
does not default to the LPT. This 
switch can be used to modify a pre- 
viously submitted request as long as 
the request has not been started. 

Accept request even if file does not 
yet exist. This is the default for the 
log file of Batch input queue. 

Output the specified text (a) in the 
output. 

Accept request even if there is 
nothing in the request. No error 
message is given. 

Print files whose extensions include 
binary information. Normally files 
with extensions . SAV, .SHR, .LOW, 
.REL, and'.HGH will not be in print 
queues. 

Do not produce message if no files 
match the wildcard construction. 



Category 



General 



Q ueues 
OUTPUT 



Queue Operation LIST 



File Control 



OUTPUT (LPT) 



Queue Operation ALL 



File Control 



File Control 



General 



File Control 



ALL 

OUTPUT 
OUTPUT 

OUTPUT (LPT) 



File Control 



OUTPUT 
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Command Formats (cont) 



Switch 
/OUTPUT :n 



/PAGE:n 



/PAPER :x 

/PHYSICAL 

/PLOT:ASCII 

/PLOTrBINARY 



. Meaning Category 

Cause job to terminate with a /Z:n General 

to KJOB (n is from to 4). 

N=0 Suppress all normal queuing 
performed at LOGOUT time. 

N=l Queue only the log file. 

N=2 Queue only the log file and 
spooled output (e.g., *.LPT). 

N=3 Queue the log file, spooled 
output, and *.LST files. 

N=4 Queue the log file, spooled 
output, *.LST files, and any 
requests deferred to LOGOUT 
time. 

Use n (decimal) as the maximum General 

number of pages of output that the 
job can print. If the switch is 
omitted, the maximum is 200 pages; 
if only the value is omitted, a max- 
imum of 2000 pages can be printed. 

Identical to /PUNCH :x, /PRINT :x, File Control 

/TAPE:x, or/PLOT:x. 

Suppress logical device names for File Control 

the specified device. 

Plot the file in ASCII mode. If File Control 

the /PLOT switch is omitted, the 
file is plotted in the data mode 
specified in the file. 

Plot the file in binary mode. If File Control 

the /PLOT switch is omitted, the 
file is plotted in the data mode 
specified in the file. 



Queues 



INPUT 



INPUT 



OUTPUT 
ALL 
OUTPUT (PLT) 

OUTPUT (PLT) 
(continued on next page) 
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QUEUE command (Cont) 



Command Formats (cont) 

Switch 
/PLOTrlMAGE 



/PRINT.-ARROW 

/PRINT:ASCII 

/PRINT :OCTAL 
/PRINTrSUPPRESS 



/PRIORITY :n 



/PROTECT :nnn 



/PUNCH :026 



/PUNCH :ASCII 



Meaning 

Plot the file in image mode. If the 
/PLOT switch is omitted, the file is 
plotted in the data mode specified in 
the file. 

Convert all control characters to up- 
arrow format except 011-015 and 
020-024. This is the default. 

Send the file to the line printer with 
no changes. 

Print the file in octal. 

Suppress all character-control char- 
acters except for ASCII code charac- 
ters LF and CR; this switch implies 
the use of the/PRINT:ARROW. 
Equivalent to operator command to 
spooler (SUPPRESS). 

Give the specified external priority 
(n = to 62) to the request. A larger 
number is greater priority. The de- 
fault is 10 if no switch is given, and 
20 if a switch is given without the 
value. 

Specify a protection nnn (in octal) 
for this job or queue entry. If the 
switch, or the value of the switch, 
is omitted, the standard protection 
is assumed. 

Punch files in 026 Hollerith code. 
If the /PUNCH switch is not given, 
the files are punched according to 
the data mode of the file. 

Punch files in ASCII card code. If 
the /PUNCH switch is not given, 
the files are punched according to 
the data mode of the file. 



Category 
File Control 

File Control 

File Control 

File Control 
File Control 



Quei 



General 



General 



File Control 



File Control 



OUTPUT (PLT) 

OUTPUT (LPT) 

OUTPUT (LPT) 

OUTPUT (LPT) 
OUTPUT (LPT) 



ALL 



ALL 



OUTPUT (CDP) 



OUTPUT (CDP) 
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Command Formats (cont) 

Switch 
/PUNCH :BINARY 



/PUNCH:D029 



/PUNCH .-IMAGE 



/REMOVE 



/REPORTrcode 
/RESTART :0 or 1 



/SEQ:n 
/SINCEit 



Meaning ■ Category Queues 

Punch files in binary card format. If File Control OUTPUT (CDP) 

the /PUNCH switch is not given, 
the files are punched according to 
the data mode of the file. 

Punch files in the old DEC 029 card File Control OUTPUT (CDP) 

code. If the /PUNCH switch is not 
given, the files are punched accord- 
ing to the data mode of the file. 

Punch files in image mode. If the File Control OUTPUT (CDP) 

/PUNCH switch is not given, the 
files are punched according to the 
data mode of the file. 

Remove the file from the queue. File Control OUTPUT 

This switch is valid only with the 

/MODIFY switch and can be used 

to remove a previously submitted 

file as long as the Batch System 

has not started processing the- job. 

Print the specified report within a File Control OUTPUT (LPT) 

COBOL report file. Code can be 
up to 12 characters in length. 

A value of (default) means the General INPUT 

job cannot be requeued or restarted 

by the operator after a system crash. 

A message is sent to the job's log 

file. A value of 1 means the job 

will be requeued or restarted. The 

job should not be restartable if there 

are changes to the permanent fi le 

directory. 

Specify a sequence number to aid General ALL 

in identifying a request to be modi- 
fied or deleted. 

Queue only the files with creation General OUTPUT 

dates after the specified time t 

where t is in the form dd-mmm-yy 

hhmm. (continued on next page) 
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QUEUE command (Cont) 



Command Formats (cont) 

Switch 
/SPACING:DOUBLE 
/SPACING:SINGLE 

/SPACING :TRIPLE 
/START :n 



Meaning 

Double-space the output lines. 

Single-space the printed lines 
(default). 

Triple-space the printed lines. 

Start on n line of the file. If the 
switch, or the value of the switch, 
is omitted, the Batch System 
starts with the first line. 

/STRS Search for the file on all structures 

in the search list and takes each 
occurrence. The default is to take 
just the first occurrence of the file. 

/TAPE ASCII Punch the tape in ASCII code. If 

the /TAPE switch is not given, the 
files are punched according to the 
data mode of the file. 

/TAPE:BINARY Punch the tape in binary mode. If 

the /TAPE switch is not given, the 
files are punched according to the 
data mode of the file. 

/TAPE:IBINARY Punch the tape in image-binary 

mode. If the /TAPE switch is not 
given, the fi les are punched accord- 
ing to the data mode of the file. 

/TAPE:IMAGE Punch the tape in image mode. If 

the /TAPE switch is not specified, 
the files are punched according to 
the data mode of the file. 

/TIME:hhmmss Specify the central processor time 

limit for the job,, If no switch is 
specified, the limit is 5 minutes; if 
the switch is specified without a 
value, the limit is 1 hour. 



Category 
File Control 
File Control 

File Control 
File Control 



File Control 



File Control 



File Control 



File Control 



File Control 



General 



Queues 
OUTPUT (LPT) 
OUTPUT (LPT) 

OUTPUT (LPT) 
ALL 



OUTPUT 



OUTPUT (PTP) 



OUTPUT (PTP) 



OUTPUT (PTP) 



OUTPUT (PTP) 



INPUT 
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Command Formats (cont) 



Switch 



/TPLOTrn 



/UNIQUE: or 1 



/UN PRESERVED 
/ZDEFER 1 



Meaning 

Use n (decimal minutes) as the max- 
imum amount of plotting time allowed 
for the job. If the switch is omitted, 
no plotter time is allowed; if the 
value is omitted but the switch is 
given, the maximum plotter time is 
10 minutes. 

Run any number of Batch Jobs under 
this project-programmer number at 
the same time, if 0. Runs only one 
Batch job at any one time, if 1 
(default). 

Output file only if not preserved. 

Create a new entry in a queue and 
defer it until LOGOUT; however, 
the deferred file is zeroed first so 
that all previous /DEFER requests 
from the current job are deleted. 



Category 



Qt 



General 



General 



INPUT 



INPUT 



Genera I 

Queue Operation 



OUTPUT 
ALL 



Characteristics 



The QUEUE command (and its associated variations): 

Leaves the terminal in monitor mode. 

Runs the QUEUE program, thereby destroying the user's core image. 
Does not require LOGIN when only queue listings are desired. 
Depends on FTQCOM which is normally absent in the DECsystem-1040. 



Associated Messages 

Refer to Chapter 4. 



Not yet implemented. 
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QUEUE command (Cont) 



Examples 



• QUEUE FILEA,FILEBj 
^QUEUE INPl=TESTj 
.QUEUE IN:PAYR=MAN i- ) 

.QUEUE DSK:A.X=/LISTj 



.QUEUE INP:FREED=FILEA/CREATE 
~/PRI0RITY:4/TIME:l :5^ 



Enter files FILEA. LPT and FILEB. LPT in the line- 
printer queue under the jobname of FILEA. 

Enter file TEST.CTL in the Batch input queue under 
jobname TEST and log file with name TEST. LOG. 

Enter file MAN.CTL in the Batch input queue 
under jobname PAYR and log file with name 
MAN. LOG. 

Place a queue listing of all jobs into file A.X in 
the user's disk area. 

Place file FILEA. CTL in the Batch input queue with 
the jobname FREED. An external priority of 4 and 
CPU time limit of one minute and five seconds are 
set for the job. The log file is named FILEA. LOG. 



jQUEUE INP3TEST»/KILL^ 

^GUEUE INP".JOBNAM = /MODIFY/TIMES2P10^ 



Remove the entry corresponding to TEST.CTL from 
the Batch input queue. 



Alter the time parameter of the entry corresponding 
to JOBNAM.CTL in the Batch input queue. 

^udfcUE INPS=JOB.CTL/PAGES:S00/TPLOT :20^ 

Establish a limit of 500 pages and 20 minutes of 
plotting on the output generated by this job. 

^QUEUE PL1 ■:» JOB. PLT/LIM 1:20^ Queue a file to PLTS PL with a limit of 20 minutes 

of plotting time. 
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QUOLST program 



Function 



The QUOLST program informs the user of both the amount of disk space he has used and the 
amount he has left on each file structure in his search list. This program also returns the 
amount of free space that the system has left 1 for all users of the structure. Free system space 
on structures not in the user's search list is not output. This information can be obtained by 
typing SYSTAT/F. 

The output given for each file structure consists of 1) the structure name, 2) the number of 
blocks used, and 3) the numbers of blocks left in the logged-in quota, in the logged-out 
quota, and on the structure. 



Command Format 



R QUOLST 



Characteristics 



The R QUOLST command: 

Leaves the terminal in monitor mode. 

Runs the QUOLST program, thereby destroying the user's core image. 



Examples 



_.rt QUOLSJ 
USErt: 


2 7*400 


LEFT:< IN) 


COUT) 




STrt 


USED 


CSYS) 


DSKA: 


'»0 


1000 


100 


4 703 


DSKB: 


491 


9509 


4509 


4240 


DSKC: 





10000 


5000 


396 



_.H blUOLST J 



USEH: 



STH 



DSKA: 



DSKB 



DSKC: 



31*50 



USED 



1022 



1735 



LEFT: (IN) 



C OUT ) 



-22 



-922 



78265 



8265 







2000 



1000 



CSYS) 



4215 



36 
6378 



The user is over quota on DSKA: 
and must delete files before he 
can logout. 
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R command 



Function 



The R command loads a core image from the system device and starts it at the location specified 
within the file (. JBSA). It is equivalent to RUN SYS: file.ext core and is the usual way to run 
a system program that does not have a direct monitor command to run it. 

This command clears all of user core. However, programs should not count on this action and 
should explicitly clear those areas of core that are expected to contain zeroes (i.e., programs 
should be self-initializing). This action allows programs to be restarted by a tC, START 
sequence without having to do another R command. 

On magnetic tape, if the low or high segment is missing, a null record is output before the EOF 
for the missing segment so that two EOFs cannot occur consecutively. Therefore, a saved null 
segment does not appear as a logical EOT (2 EOFs in a row). 



Command Format 



R file.ext core 



Arguments are the same as in the RUN command except that SYS: is used as the default 
device. On nondisk monitors, the default is the generic name that matches the system 
device.) Refer to the RUN command for a discussion of the core argument. 

The extension applies to the low file, not the high file. An extension of .SHR, then 
. HGH, is assumed for the high file. If the user types an extension of . SHR or . HGH, 
the extension is treated as a null extension since .SHR and .HGH are confusing as low 
file extensions. 



Characteristics 



The R command: 



Places the terminal in user mode. 
Runs a system program. 



Associated Messages 

Refer to Chapter 4. 

Examples 

* 

.R PIP 5 J 

* 
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REASSIGN command 



Functi 



The REASSIGN command allows one job to pass a device to q second job without having the 
device go through the monitor device pool (restricted or unrestricted). Both restricted and un- 
restricted devices can be reassigned. This command, applied to DECtapes, clears the copy of 
the directory currently in core, forcing the next directory reference to read a new copy from 
the tape, but does not clear the logicalTfcme assignment. If a device is INITed, a 
RELEASE UUO is performed unless the user issuing the command is reassigning the device to 
himself. 



Command Format 



REASSIGN dev job 

dev = the physical or logical name of the device to be reassigned. This argument is 
required. 

job = the number of the job to which the device is to be reassigned. If no job is 
specified, the device is reassigned to the job issuing the command. This is useful 
when the user wants to force the next directory reference to come from the tape instead 
of core . 

A logical name which is also a physical name can be reassigned only if the job issuing the com- 
mand and the job to which the device is to be reassigned have the same project-programmer 
number, or the user issuing the command has operator privileges (logged-in under [1,2] or 
logged-in at OPR). However, a logical name cannot be duplicated; i.e., two devices can- 
not have the same logical name. 



Characteristics 



The REASSIGN command: 

Leaves the terminal in monitor mode. 

Requires core. 

Does not operate when the device is currently transmitting data. 



Restrictions 



The job's controlling terminal cannot be reassigned. 
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REASSIGN command (Cont) 



Associated Messages 



Refer to Chapter 4. 



Examples 



^REASSIGN LPT:17^ 
.REASSIGN CDPI4 J 



Reassign the line printer to job 17. 
Reassign the card punch to job 4. 
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REATTA program 



Function 



The REATTA program allows a user to transfer his job from one terminal to another. Unlike the 
ATTACH command, REATTA does not require a password or that the terminal be of the same 
type that LOGIN recognizes in order to run the job. For example, usually a [1,2] job can 
run only on a local terminal . However, the REATTA program can be used to attach a [1 ,2] 
job from a local terminal to a remote terminal . 

Before reattaching his job, the user should verify that the terminal to which he is attaching is 
turned on and working properly. Otherwise, it might be difficult to retrieve the job. 

Command Format 

J* REATTA J 

REATTA responds by asking for the new terminal name. 

TYPE NEW TTY NAME: 

The user answers with either the new terminal name (e.g., CTY, TTY2) or number 
(e.g., 2). REATTA then responds with 

FROM JOB n 

on the old terminal, and 
NOW ATTACHED TO JOB n 

on the new terminal . 

Characteristics 

The R REATTA command: 

Leaves the terminal in monitor mode. 

Runs the REATTA program, thereby destroying the user's core image. 

Restrictions 



The R REATTA command is not available to Batch users. 
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R EATTA program (Cont) 



Associated Messages 

Refer to Chapter 4. 

Examples 

.R REATTA^ 

TYPE NEW TTY N A ME; TTY 27 J 

FROM JOB 7 



;appears on old terminal 



NOW ATTACHED TO JOB 7 



; appears on TTY 27 
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REENTER command 



Function 



The REENTER command is similar to the DDT command. It copies the saved program counter 
value from . JBPC into . JBOPC and starts the program at an alternate entry point specified in 
. JBREN (must be set by the user or his program). If the job was executing a UUO when it was 
interrupted (i.e., in exec mode but not in TTY input wait or SLEEP mode), the monitor con- 
tinues the job until the UUO is completed and then traps to the REENTER address in .JBREN. 
If the job is in TTY input wait or SLEEP mode, the trap to the REENTER address occurs immedi- 
ately and .JBOPC contains the address of the UUO. If the job is in user mode, the trap also 
occurs immediately. Therefore, it is always possible to continue the interrupted program after 
trapping by executing a JRSTF@. JBOPC. 



Command Format 
REENTER 

Characteristics 

The REENTER command: 

Places the terminal in user mode. 

Requires core. 

Requires the user to have a job number. 

Associated Messages 

Refer to Chapter 4. 

Example 

.REE^ 
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I RENAME command 1 



Function 

The RENAME command changes the name of one or more files on disk or DECtape. 

Command Format 

RENAME arg 

arg = a pair of file specifications separated by an equal sign, or a string of such pairs 
-separated by commas: 

RENAME new! = oldl,new2 = old2,... 

Device or file structure "names can be specified only with the new filename and remain 
in effect until changed or until the end of command string is reached. In addition, a 
protection may be specified with the new filename and remains in effect only for that 
filename. This command accepts the full wildcard construction. 

Characteristics 

The RENAME command: 

Leaves the terrrinal in monitor mode. 

Runs the PIP program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 

Associated Messages 

Refer to Chapter 4. 



This command runs the COMPIL program, which interprets the command before running PIP. 

Version 20 COMPIL 
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RENAME command (Cont) 



Example 



^RENAME T! 1 .MAC=T1 .MAC^ 
FILES RENAMED; 
Tl .MAC 



.RENAME *.BAK=*.MACV 

FILES RENAMED; 

Tl 1 .MAC 

Tg.MAC 

T3 . MAC 

.RENAME TEST. MAC <057>=TEST. MAC ^ 
FILES RENAMED; 
TEST . MAC 
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RESOURCES command 



Function 



The RESOURCES command prints the names of all available devices (except TTY's and PTY's), 
all file structures, and all physical units not in file structures (unless they are down or non- 
existent). 



Com m and Format 

RESOURCES 

Characteristics 



The RESOURCES command: 

Leaves the terminal in monitor mode. 
Does not require LOGIN. 



Example 



i RES -> 



DSKA > DSKB f D3KCiD P B0/DPBl.CDRg > 2,PTRg,LPTe r l f 2 7 3 l i DTA0,3f4,5,6,7 > MTA0<l>2> 
PTP0,CDP0,PLT0. t P. IS0, 
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RESTORE program 



Function 



The RESTORE program enables the user to place back onto disk that which was saved on the 
backup medium (magnetic tape, disk, or DECtape) with the BACKUP program. This includes 
restoring the entire disk or a subset of the disk. The data to be returned to the disk is read 
from the BACKUP SET file. This file contains the data that was saved with one BACKUP com- 
mand. On a restore, either the BACKUP SET file can be scanned for the desired files or the 
index file can be searched to determine where the requested data is stored within the 
BACKUP SET file. The index file contains the directories of all areas written on the backup 
medium along with the relative block number in the BACKUP SET file where each file begins. 
When the entire backup medium is being restored, the RESTORE program starts at the beginning 
of the index file and continues until it reaches the last file in the index. 

During a restore, a command recovery file is created that contains information concerning the 
portion of the user's command that has been executed and the portion that is remaining. This 
file resides on the disk and is updated as portions of the user's request are completed. The com- 
mand recovery file is valuable if the system fails because only part of the restore need be 
redone. 

As files are restored to disk, UFDs are created for each file structure on which the user has 
files. These newly created UFDs are then entered into the MFD. 



Command Format 



R RESTORE 



The following commands may be typed by the user after the RESTORE program outputs 
a slash. These commands are stored in core and are not processed until the START 
command is given. The full wildcard construction may be used to replace the file- 
name or the extension (refer to Paragraph 1 .4.2.4). 



Command 



BACKSPACE RLE 



BACKSPACE SET 



BACKSPACE UFD 



Explanation 

Backspaces the magnetic tape to a user file header and positions 
the tape before the header. 

Backspaces the magnetic tape to a BACKUP header and positions 
the tape either before the header or to the beginning of the tape 
if there is no BACKUP header (i.e., there is only one BACKUP set 
on the tape). 

Backspaces the magnetic tape to a UFD header and positions the 
tape immediately before the header. 

(continued on next page) 
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RESTORE program (Cont) 



Command Format (conr) 

Command 
DELETE dev:file.ext 

DENSITY MT An :x 



DUMP ONdev:file.ext 



ERROR DUMP/swirch 



ERROR HALT/swirch 



INDIEX dev:file.ext 



Explanation 

Deletes the named file from the designated device. This device 
must be one on which a BACKUP has been done. 

Sets the magnetic tape density as specified by x. 



x = 2 
x = 5 
x = 8 



200 bpi 
556 bpi 
800 bpi 



The default is the system standard defined at MONGEN time. 
Dumps the contents of the BACKUP set file beginning at the present 
position and ending at the next file control word. All types of 
errors are ignored. The device on which a dump is to be written 
may not be a listing device. 

* 
Returns to the last file control word and dumps the file if a trans- 
mission error of the type specified has occurred. 

/switch = any or all of the following 

/CHECKSUM 
/PARITY 
/fcEAD 
/WRITE 

Halts program execution if the type of error specified by /switch 
occurs during restoring. An asterisk is typed to the user so that he 
may type further instructions. The user may want to backspace 
the tape and dump it. The command recovery file is destroyed 
unless simply a START command is given. In this case, the current 
file is skipped and the next command in the recovery file is 
executed. 

/switch = any or all of the following: 

/CHECKSUM 
/EXCEPT 
/PARITY 
/READ 

Reads the index file with the designated filenames from the device 
specified. 

(continued on next page) 
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RESTORE program (Cont) 



Command Format (cont) 

Command 
LOG dev:file.ext /switch 



PARITY dev: ODD or EVEN 



RESTORE devl: [p,p] file.ext 
*- dev2/switch 



REWIND dev: 

SET ACCESS dd-mmm-yy 

SET CREATION dd-mmm-yy 

SKIP dev: FILE 
SKIP dev: SET 

SKIP dev: UFD 
START 

UNLOAD dev: 



Explanation 

Writes a file on the specified device so that operations of the 
RESTORE program can be recorded. The default is 
DSK:RESTOR.LOG. 

/switch = /ERROR 

Logs only the errors. If this switch is omitted, all operations are 
recorded . 

Specifies the parity on magnetic tape as odd or even. The default 
is odd. 

Writes the specified files from dev2 to the designated area on devl . 
For example, if all of the disk is to be restored from the entire 
BACKUP SET file, the command is 

RESTORE DSK: -MTAl: 

/switch = /EXCEPT file descriptor 

Indicates the files that should not be restored. 

On magnetic tape, closes BACKUP set and rewinds tape. On disk, 
closes BACKUP set. 

Sets the access date to be used when restoring files. The files will 
be restored only if accessed after this date. 

Sets the creation date to be used when restoring files. The files 
will be restored only if created after this date. 

Advances to next file trailer, EOF!, and positions after it. 

Advances to next BACKUP set trailer and positions after it, or 
skips to end of the tape and positions the tape between the tape 
marks . 

Advances to next UFD header, HDR1, and positions before the 
header. 

Begins execution of a series of commands entered previously. 
Commands are not processed until a START command. If there are 
no commands to be processed when the START is executed, the 
command recovery file is searched for an executable command. 

Performs a rewind and unload to the magnetic tape. 
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RESTORE program (Cont) 



Command Format (cont\) 



The RESTORE program may be restarted by the user at any time. The user can cancel 
current requests and specify new ones with a tC tC START sequence. The command 
recovery file is deleted with a tC START sequence unless the next command given to 
RESTORE is a START. If this is the case, the command recovery file is searched and 
the RESTORE program proceeds according to the information in the file. A tC CONT 
sequence does not delete the command recovery file; this sequence of commands com- 
pletes the current requests. 

Upon completion of all requests, the RESTORE program closes the log file and types an 
asterisk on the user's terminal indicating its readiness for more requests. Rewinds to the 
magnetic tape due to it being filled are actually rewind and unload operations to en- 
sure that the magnetic tape is not overwritten. When the RESTORE program reaches 
completion, the magnetic tape last written on remains in position unless a REWIND 
command is given. 



Characteristics 

The R RESTORE command: 

Runs the RESTORE program, thereby destroying the user's core image. 

Associated Messages 

Refer to Chapter 4. 
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REWIND command 1 



Function 

The REWIND command rewinds a magnetic tape or a DECtape. This command is equivalent to 
the PIP command string: 

dev:(MW)- 

Command Format 

REWIND dev: 

dev: = a magnetic tape (MTAn) or a DECtape (DTAn). 



Characteristics 

The REWIND command: 

Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 

Associated Messages 

Refer to Chapter 4. 

Examples 

^REW D7f\A:J 
^REWIND MTA1 : J ' 



This command runs the COMPIL program, which interprets the command before running the PIP program. 
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RUN command 



Function 



The RUN command loads a core image from a retrievable storage device and starts at the 
location specified within the file (. JBSA). 

If the program has two segments, both the low and high segments are set up. If the high file 
has extension .SHR (as opposed to .HGH), the high segment will be shared. Therefore, if the 
-user has RUN (or GET) the same program, I/O will not usually be required for the high seg- 
ment. A two-segment program may have a low file extension (.LOW). 

The RUN command clears all of user core. However, programs should not count on this action 
and should explicitly clear those areas of core that are expected to contain zeroes (i.e., the 
programs should be seif-initializing). This action allows programs to be restarted by a 
C, START sequence without having to do another RUN command. 

On magnetic tape, if the low or high segment is missing, a null record is output before the 
EOF for the missing segment so that two EOFs cannot occur consecutively. Therefore, a saved 
null segment does not appear as a logical EOT (2 EOFs in a row). 



Command Format 



RUN dev:file.ext [proj, prog] core 

dev: = the logical or physical name of the device containing the core image. The de- 
fault device name is DSK:.(In nondisk monitors, the default is the generic name that 
matches the system device.) 

file.ext = the name of the file containing the core image; .ext applies to the low file, 
not the high file. An extension of .SHR, then .HGH, is assumed for the high file. If 
the user types an extension of .SHR or .HGH, the extension is treated as a null exten- 
sion since .SHR and .HGH are confusing as low file extensions. The default filename 
is the job's current name as set by the last R, RUN, GET, SAVE, or SSAVE command, 
the last SETNAM UUO, or the last command which ran a program. 

[pro}, prog] = the project-programmer number; required only if core image file is loca- 
ted in a disk area other than the user's. 

core = the amount of core to be assigned to the sum of the low and high segments if 
different from minimum core needed to load the program or from the core argument of 
the SAVE command which saved the file. 

If core < the minimum low segment size, then an error message occurs. 

If core > the minimum low segment size and < the sum of the high segment and the min- 
imum low segment size, then the core assignment is the low segment size. 

If core _> the sum of the minimum low segment and the high segment size, then the core 
assignment is the size of both the low and high segments to be used. 
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RUN command (Cont) 



Command Format (cont) 



Core arguments can be specified in units of 1024 words or 512 words (a page) by 
following the number with K or P, respectively. For example, 2P represents 2 pages 
or 1024 words. If K or P is not specified, K (1024 words) is assumed. 

Note that on KA10 based systems (DECsystem-1040, 1050, 1055), the minimum unit 
of allocation is 1024 words. Therefore, all arguments are rounded up to the nearest 
multiple of 1024 words (e.g., 3P is treated as 2K on a KA10 based system). 

Since previous core is returned, MTA must have the core argument because there is no 
directory telling how much core is for the low segment. Refer to Appendix D. 



Characteristics 



The RUN command: 

Places the terminal in user mode. 



Restri cti ons 

On systems with a large amount of core memory, the user should not specify a core argument 
that forces the high segment to start higher than 400000 (i.e., a core argument of greater than 
128K) unless the program's high segment is location independent. If this is done, the 
ILLEGAL UUO error message is likely to occur. 

Associated Messages 

Refer to Chapter 4. 

Examples 

.RUN TEST*) 

^RUN HISTST C10,633^ 

.RUN DTA3:TEST1*> 
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ISAVE command 



Function 



The SAVE command writes out a core image of the user's core area on the specified device. 
It saves any user program (two-segment sharable, one-segment nonsharable, or two-segment 
nonsharable) as one or two files. Later, when the program is loaded by a GET, R, or RUN 
command, it will be nonsharable. If DDT was loaded with the program, the entire core area is 
written; if not, the area starting from zero up through the program break (as specified by . JBFF) 
is written. Refer to DE Csystem-10 Monitor Calls for a description of the job data area loca- 
tions referenced by this command. 

The SAVE command should be used instead of the SSAVE command when debugging a two- 
segment program. Refer to Appendix D for additional information on the SAVE command. 

On magnetic tape, if the low or high segment is missing, a null record is output before the 
EOF for the missing segment so that two EOFs cannot occur consecutively. Therefore, a 
saved null segment does not appear as a logical EOT (2 EOFs in a row). 



Command Format 



SAVE dev:f?le.ext [proj jr prog] core 

dev = the device on which the core image file is to be written. The default device 
name is DSK:. In nondisk monitors, the default is the generic name that matches the 
system device. The colon following the device name is required if a device is speci- 
fied. 

file.ext = the name to be assigned to the core image file. The default filename is the 
job's current name as set by the last R, RUN, GET, SAVE, or SSAVE command, the 
last command which ran a program (e.g., DIRECT), or the last SETNAM UUO. 

ext applies to rhe low file, not the high file. An extension of .SHR, then .HGH, is 
assumed for the high file. If the user types an extension of .SHR or .HGH, the exten- 
sion is treated as a null extension since .SHR and .HGH are confusing as low file ex- 
tensions. If ext is omitted and the program has only one segment, the ext is assumed 
to be .SAV. If ext is omitted and the program has two segments, the high segment will 
have extension .HGH, and the low segment will have extension .LOW. 

[proj,prog] = the name of the disk area on which the core image file is to be written. 

core = the amount of core in which the program is to be run. This value is stored in 
JOBDAT as the job's core area (. JBCOR) and is used by subsequent RUN and GET 
commands. This argument is optional. 

Core arguments can be specified in units of 1024 words or 512 words (a page) by 
following the number with K or P respectively. For example, 2P represents 2 pages or 
1024 words. If K or P is not specified, K (1024 words) is assumed. 
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SAVE command (Cont) 



Command Format (cont) 



Note that on KAU) based systems (DECsystem-1040, 1050, 1055), the minimum unit of 
allocation Is 1024 words. Therefore, all arguments are rounded up to the nearest 
multiple of 1024 words (e.g., 3P is treated as2K on a KA10 based system). 

If core is omitted, only the number of blocks required by the core image area (as ex- 
plained in the RUN command description) is assumed. 



Characteristics 



The SAVE command: 



Leaves the terminal in monitor mode. 

Requires core. 

Does not operate when a device is currently transmitting data. 



Ass ociated Messages 

Refer to Chapter 4. 

Example 

.SAVE,/ 
JOB SAVED 

.SAVE DTA3:TEST^ 
JOB SAVED 
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I SCHED command J 



Function 



The SCHED command types out the schedule bits as set by the last privileged SET SCHED com- 
mand. The schedule bits are as follows: 

regular timesharing. 

1 no further logins allowed except from CTY. 

2 no further logins from remote terminals, and no answering of data sets. 
4 batch jobs only. 

100 device mounts can be done without operator intervention. 
200 unspooling allowed. 
400 no operator coverage. 



Command Format 
SCHED 



Characteristics 



The SCHED command: 

Leaves the terminal in monitor mode. 
Does not require LOGIN. 

Depends on output from the SET SCHED command which is normally absent in the 
DECsystem-1040. 



Example 



.SCHEDJ 
000400 



Regular timesharing, but no operator coverage. 
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SEND command 



Function 



The SEND command provides a mechanism for one-way interconsole communication. (This 
command replaces the TALK command.) A line of information Is transmitted from one terminal 
to another, with the identification of the terminal sending the information. With remote com- 
munications capabilities, SEND is able to differentiate between stations. 

When the SEND command is sent from the central station operator's terminal (OPR) or from a 
terminal logged in as [1,2], it allows a broadcast of a line of information to all non-slaved 
terminals (including remote terminals) in the system. This allows important information to be 
dispersed, such as system shutdown or hardware problems. SEND ALL messages do not go to 
slaved terminals unless the SET TTY NO GAG bit is set to permit reception when the terminal 
is busy. 

A busy test is made on single-destination messages before the message is sent unless the sender 
or the receiver of the message is OPR or a job logged-in as [1,2]. The receiver of the message 
is considered busy if his terminal is not at monitor command level. If the receiver is busy, the 
sender receives the message BUSY and the information is not sent, unless the receiving terminal 
has the TTY NO GAG bit set (refer to the SET TTY command). If the receiving terminal is 
turned off, the information appears to have been sent, since the hardware cannot detect this 
condition on hard-wired terminals. 



Command Format 



SEND dev: text 

or 

SEND JOB n text 



dev = any physical terminal name (CTY included) or OPRnn. If OPRnn is specified, 
the message is sent to the operator at station nn. If OPR (nn is null) is specified, the 
message is sent to the operator at the user's logical station. If the terminal sending 
the message is the operator's terminal, the argument may be ALL to provide the broad- 
cast operation. 

n = the job number to which the message is to be sent. 

The message printed on the receiving terminal appears as follows: 
;;TTY n: - text 



fhere 



n is the TTY sending the message, and text is the message. A bell sounds on 
the receiving terminal when the message is sent. 
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SIEND command (Cont) 



Characteristics 



The SEND command: 



Leaves the terminal in monitor mode. 

Does not require LOGIN. 

Depends on FTTALK which is normally absent in the DECsvstem-1040. 



Restrictions 



The SEND command is not available to the Batch user. 

Associated Messages 

Refer to Chapter 4. 

Examples 

^SEND OPR: PLEASE WR ITE-ENABLE DTA3J 
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SET BLOCKSIZE command | 



Function 

The SET BLOCKSIZE command sets a default blocksize for the specified magnetic tape. 

Command Format 

SET BLOCKSIZE dev: nnnn 

dev: = MTAn: where n is the number of the magnetic tape drive for which the blocksize 
is to be set, or a logical name associated with a physical magnetic tape. The user 
must have the magnetic tape assigned to him. This argument is required. 

nnnn = a decimal number up to a maximum of 4095 designating the block size for this 
magnetic tape. No additional checking is done for the legality of the specified num- 
ber besides the check for the maximum 4095. This argument is required. 

Characteristics 

The SET BLOCKSIZE command: 

Leaves the terminal in monitor mode. 

Depends on both FTSET and FTMTSET which are normally absent in the DECsysrem-1040. 

Examples - 

.SET BLOCKSIZE MTA2:395^ 

■ 

.ASSIGN MTA4JNAMEO 

KTA4 ASSIGNED 

.SET BLOCKSIZE NAME:2000.) 
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J SET CDR commandTI 



Function 

The SET CDR command sets the filename for the next card-reader spooling intercept (refer to 
DECsystem-10 Monitor Calls). This command is generally not needed, even when the card 
reader is being simulated on the disk via the spooling mechanism. It is included in case the 
user w.shes to reset or change the spooling. In addition, the Batch Controller uses this com- 
mand to read spooled input card decks. 

Command Format 

SET CDR filename 

filename = one- to three -character filename to be used on next card-reader INIT. 
Characteristics 

The SET CDR command: 

Leaves the terminal in monitor mode. 

Depends on FTSET and FTSPL which are normally absent in the DECsystem-1040. 

Examples 

^SET CDR A J 
TSET CDR MAS^ 
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SET CPU command 



] 



Function 



The SET CPU command allows a privileged user to change the CPUs on which his Job can run. 
It is used in a multiprocessing system to specify whether the programs run under the job can be 
processed on the primary CPU, the secondary CPU, or either CPU. The job remains with the 
specified CPU until (1) another SET CPU command with a different specification is given, (2) 
a KJOB command is issued, or (3) the user's program overrides the SET CPU command by issuing 
the SETUUO with a different specification. If the SETUUO overrides the command, the 
specification given in the UUO remains in effect until a RESET or EXIT UUO or another SETUUO 
with a different specification is executed. When an EXIT or RESET UUO Is executed, 
the job reverts back to the specification given in the last SET CPU command. When the user 
logs in, the CPU specification is usually set to ALL. The schedulers for each CPU compete 
for jobs with the ALL specification so that the load is dynamically balanced between CPUs. 
Therefore, this command is generally not needed but is provided in case the user wishes to 
change the CPU specification. 



Command Formats 



1. SET CPU CPxn 

adds the specified CPU to the job's CPU specification. 

2. SET CPU NO CPxn 

removes the specified CPU from the job's CPU specification. 

3. SET CPU ALL 

adds all of the CPUs to the job's CPU specification. 

4. SET CPU ONLY CPxn 

changes the CPU specification so that it includes only the specified CPU. 

x = either U designating a logical name or A or I designating physical names for 
a KA10 processor (DECsystem-1055) or a K1 1 processor (DECsystem -1077), 
respectively. 

n = a decimal number from to the number of processors in the system. 
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SET CPU command (Cont) 



Characteristics 

The SET CPU command: 



Leaves the terminal ?n monitor mode. 

Depends on FTSET and FTMS which are normally absent in the DECsystem-1040 1050 
and 1070. ' 



Restrictions 



The privileges required For using this command are determined by bit 5 (JP.CCC) of the 
privi lege word, .GTPRV. 

Assoc iated Messages 

Refer to Chapter 4. 

Examples 

J.SET CPU ONLY CPUIJ 
TsET CPU CPA0^ 
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SET DENSITY command 



Function 

The SET DENSITY command sets a default density for the specified magnetic tape. 

Command Format 

SET DENSITY dev: nnn 

dev: = MTAn: where n is the number of the magnetic tape drive for which the density 
is to be set, or a logical name associated with a physical magnetic tape. The user must 
have the device assigned to him. This argument is required. 

nnn = 200 bpi 
556 bpi 
800 bpi 

This argument is required. 

Characteristics 

The SET DENSITY command: 

Leaves the terminal in monitor mode. 

Depends on both FTSET and FTMTSET which are normally absent in the DECsystem-1040. 



Examples 



_jSFT DFNSITY MTA5: 556^ 
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SET DSKPRI command 



Function 



The SET DSKPRI command allows a privileged user to set the priority for his job's disk operations 
(data transfers and head positionings). The standard priority is 0, and the range of permissible 
values is -3 to +3. This means that a priority lower than the standard can be specified, as well 
as one higher than the standard. The priority specified applies to all disk I/O channels cur- 
rently open or subsequently opened whose priority has not been explicitly set with a DISK. UUO 
(refer to DECsystenv -1 Monitor Ca lls). The priority specified in the SET DSKPRI command re- 
mains in effect unti l"Tl ) another SETHDSKPRI command is given with a different priority, (2) a 
KJOB command is issued, or (3) the user's program overrides the SET DSKPRI command by 
issuing a DISK. UUO with a different priority. 



Command Format 



SET DSKPRI n 



n - a decimal number from -3 to +3 indicating the priority to be associated with the 
job's disk operations. When n = 0, the priority is the normal timesharing priority. 



Characteristics 



The SET DSKPRI command: 

Leaves the terminal in monitor mode. 

Depends on both FTSET and FTDPRI which are normally absent in the DECsystem-1040. 



Restrictions 



The privileges required for using this command are determined by bits 1 and 2 of the privilege 
word, .GTPRV. These two bits specify an octal number from 0-3. The user is always allowed 
a priority. 



Examples 



^SET DSKPRI 2J 
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SET HPQ command 



Function 



The SET HPQ command allows a privileged user to place his job in a high-priority scheduler 
run queue. With this command, the user obtains a faster response and CPU time than in the 
normal timesharing queues. The job remains in the specified high-priority queue until (1) 
another SET HPQ command to a different high-priority queue is given, (2) a KJOB command is 
issued, or (3) the user's program overrides the SET HPQ command by issuing an HPQ UUO with 
a different value. If an HPQ UUO overrides the command, the level specified in the UUO re- 
mains in effect until a RESET or EXIT UUO or another HPQ UUO with a different value is exe- 
cuted. When an EXIT or RESET UUO is executed, the job is returned to the high-priority queue 
specified in the SET HPQ command. 



Command Format 



SET HPQ n 



n = a decimal number from to 15 indicating the high-priority queue to be entered. 
When n = 0, the queue is the normal timesharing run queue. Queue numbers from 1 
to 15 are high-priority queues. The number of high-priority queues is an installation 
parameter and may be less than 15. 



Characteristics 



The SET HPQ command: 

Leaves the terminal in monitor mode. 

Depends on both FTSET and FTHPQ which are normally absent in the DECsystem-1040. 

Restrictions 

The privileges required for using this command are determined by bits 6 through 9 of the privi- 
lege word, .GTPRV. These four bits specify an octal number from 0-17, which is the highest 
priority queue attainable by the user. 

Examples 

^SFT HPQ Aj 
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SET SPOOL command 



Function 



The SET SPOOL command adds devices to or deletes devices from the current list of devices 
being spooled for this job. Spooling is the mechanism by which I/O to or from slow-speed de- 
vices is simulated on disk. Devices capable of being spooled are: the line printer, the card 
punch, the card reader, the paper tape punch, and the plotter. 



Command Formats 



1. SET SPOOL devl, dev2, ...devn 

adds the specified devices to the job's spool list. 

2. SET SPOOL ALL 

places all spooling devices into the spool list. 

3. SET SPOOL NONE 

clears the entire spool list. 

4. SET SPOOL NO devl, dev2, . ..devn 

removes the specified devices from the job's spool list. 

devl , dev2, . . . devn = names of one or more devices to be added to or deleted from 
the current spool list. 



Characteristics 



The SET SPOOL command: 

Leaves the terminal in monitor mode. 

Depends on both FTSET and FTSPL which are normally absent in the DECsystem-1040. 



Restrictions 



To unspool devices, the job must have (1) the privilege bit set in .GTPRV, (2) bit 28 (200 
octal) set in the STATES word by the operator SET SCHED command, or (3) the user must be 
logged-in under [1,2] . 
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SET SPOOL command (Cont)| 



Associated Messages 



Refer to Chapter 4. 



Examples 



SET SPOOL CDPt^ 

Tset SPOOL no lpt:^ 
TSET SPOOL NONE^ 
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[ 



SETSRC program 



Function 



The SETSRC program is used to manipulate the job's search list or the system's search list A 
search list is defined to be the order of file structures that are to be searched whenever generic 
device DSK: is explicitly or implicitly specified by the user. This search list is originally de- 
«® D r SySterTl manager to include th e f'le structures which the user can access. With the 

SETSRC program, the user can alter the search list defined for him by adding or deletinq file 
structures. 

The search list is in the form 

fsl/s/s, fs2/s/s, . . . , FENCE, . . . . , f s 9/s/s 

where fs is the name of the fi le structure and /s is a switch modifying the fi le structure. The 
f. le structures on the left of the FENCE comprise the active search list and represent the 
generic device DSK for this job. The files to the right of the FENCE comprise the passive 
search list and represent file structures that Were once in the active search list. File structures 
are kept in the passive search list in order that quotas can be checked on a DISMOUNT or 
KJOB command. The FENCE represents the boundary between the active and passive search 
list. 

Note that the MOUNT and DISMOUNT commands can also change the job's search list by 
adding or deleting a file structure. Since the SETSRC program does not create a UFD if one 
does not exist, the MOUNT command should be used to create a UFD. The name of the new 
file structure is placed at the end of the search list. 

Refer to the SETSRC specification in the DECsy stem-10 Software Notebooks for a complete 
description of the SETSRC program, ~~~ " 



Command Format 



R SETSRC 

The user can then respond with any of the following commands: 

Command Explanation 

A Add one or mote file structures to the existing search list. The file struc- 

tures (with any switches) are appended to the beginning or the end of the 
active search list according to the following specifications: 

1. If no asterisk appears in the specification (e.g., fsl, fs2) or if an 
asterisk appears before the file structure names (e.g., *, fsl, fs2), 
the file structures are added to the end of the search list. 

(continued on next page) 
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SETSRC program (Cont) 



Command Format (cont) 

Command 
A (cont) 



Explanation 

2. If the asterisk follows the file structure names (e.g., fel, fs2, *), the 
fi le structures are added to the beginning of the search list. 

3. If the asterisk appears in the middle of the fi le structures (e.g. , 
fsl * fs2) the fi le structures before the asterisk are added to the 
beginning of the search list and the fi le structures after the asterisk 
are added to the. end. 

If the specified file structure is currently in the search list, it is removed 

and then added in the desired position. Therefore, this command can be 

used to reorder the search list. 

Create a new search list for this job. Any file structures in the current 

search list which are not in the new list are moved to the pass.ve search 

list. . 

Create a new default directory path. 

Create a new system search list (i .e. , the fi le structure search list for 

device SYS:). The user must be logged in under [1,2] to use th.s command. 

Obtain information about the available commands. 

Modify the current search list and DSK specification by altering the switch 

settings for individual file structures. This command does not add or 

remove file structures from the search list. 

Remove fi le structures from the search list They are placed on the .right 

side of the FENCE (passive search list) so that on subsequent LOGOUTS or 

DISMOUNTS quota limits can be checked. 

Type the search list of the job. 

Type the default directory path. 

Type the system search list. 

The following switches can be used in the SETSRC command string. Switches that modify file 
^uctureTmust appear immediately after the file structure that they mod, fy. Other sw.tches 
ZToppLT^yZre in the command string. The switches can be abbreviated as long as the 
abbreviation is unique. The minimum number of characters .s underlined below. 

Switches that modify file structures 

/CREATE Allow new files to be created on the file structure. 

(continued on next page) 



CP 
CS 

H 
M 



T 

TP 

TS 
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[ 



SETSRC 



program 



(Cont) | 



Command Format (con t) 
/NOCREATE 

/NOWRITE 
/WRITE 



Do not allow new files to be created on the file structure when DSK is 
specified, but allow files to be superseded. Files can-be created on the 
file structure if the user specifies the file structure name explicitly. 

Do not a I low writi ng on the fi le structure for this fob (i.e. the fi le 
structure is read only). ' 

Allow writing on the file structure. 



If no switches are specified, /CREATE and /WRITE are assumed. For compatibi lity with 
prev.ous versions of SETSRC, /N is equivalent to /NOCREATE and /ReauTva!e^to /NOWRITE. 
Switches that modify the directory path (used only with the CP command) 

<"l e N r„M ; n tA™ Mi by omi,,in9 ,he cp ™ d - d *• •'- 

/NOSCAN Cancel the scan switch for the directory path. 

/SCAN S e t the scan switch for the directory path. 

Switches that modify the DSK or SYS specification (used only with the C and M commands) 

iTri'^V^ tyPed ,n , ^'^/.r C ° mmandS * 0mi,Hn 9 the C <* M ""-and and the 
slash (i.e., NOSYS is equivalent to M/NOSYS). 

/UB: [ prof, prog] Set the job's library directory to the UFD [ P rof,prog] and add it to the 
user^s DSK specification. This means that if a file is not found in the 
user * directories in his search list, the library directory will then be 
searched for the file. 



/NOLIB 
/NOSYS 
/NONEW 
/SYS 



/NEW 



Remove the library directory from the user's DSK specification. 

Remove the SYS specification from the user's DSK specification. 

Remove the [1,5] directory from the user's SYS specification. 

Add the SYS specification to the user's DSK specification. This means that 

.fa file cannot be found in the user's directories in his search list or in his 

library directory (, /LIB: [ proj,prog] has been specified), the system 

di rectory [ 1 , 4.1 wi 1 1 then be searched for the fi le. 

Add the directory [ l /5 ] to the user's SYS specification. This means that 

Iflr. t h T™, T^ searc "ed, the directory [ l /5 ] will be searched 
oetore the directory [1,4]. 



Characteristics 

The R SETSRC commend 



Places the teminal in user mode. 

Runs the SETSRC program, thereby destroying the user's core image. 
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SETSRC program (Cont) 



Restrictions 



The user must be logged in under [1,2] to create a new system search list. The directory path 
rommonds (CP and TP) are meaningful only with the 5.04 and later monitors and only if FTSFC 



is on. 



Examples 



• R SETSRC^ 

DSKB:, FENCE The user's search list is defined as DSKB. 

*A DSKA: ) Add DSKA to tne end of tne search list. 

DSK B:, DSKA :., FENCE The user's search list is defined as DSKB, DSKA. 

*A DSKC : , * J ' Add 'DSKC to the beginning of the search list. 

DSKC :,DSKB: , DSK A:, FENCE -.„. . . , ,. . 

*rt DSKA; " "~ — Remove DSKA from the search list. 

D S KC :, PS KB :, FENCED DSKA : The user's search list is defined as DSKC, DSKB. 

*h> DSKB :/NOwrtITE ) Do not allow writing on DSKB. 

*». y« tu . rov u.^m i ^ Set the user's library directory to [27,500] and add 

*fc /LIB : Id / >b\dw J J r.. ' . r . '. 

- " it to the user's DSK specification. 

*S*S \ Add SYS: to the user's DSK specification. 

* iO 

/LIB:[a7,5 00 3/SYS DSKC : ,DSKB ; /NOWrt ITE, FENCE, PS KA : 

The user's DSK and SYS specifications are first 
followed by the user's search list. 

*' rb J 

DSKA:, DSKB:, DSKC:, FENCE The system search list is defined as DSKA,DSKB, 

— DSKC. 



Version 11 SETSRC 2 ' 203 



COMMANDS -666- 



SET TIME command 



Functi 



The SET TIME command sets a central processor time limit for a fob. When the time limit is 
reached, the job is stopped and a message is typed. A timesharing job may be continued by 
typing CONT, but no time limit is in effect unless it is reset. A Batch job cannot be con- 
tinued. 



Command Format 



SET TIME n 



I 



n - numbesr of seconds of central processor time to which the job is limited. An argu- 
ment of cancels the time remaining. 



Characteristics 



The SET TIME command: 

Leaves the terminal in monitor mode. 

Depends en both FTSET and FTTLIM which are normally absent in the DECsystem-1040. 



Associated Messages 



Refer to 


Chapter 4. 


Examples 




.MAKE 


L00P.F/1^ 


♦IIP" 


CONTINUE 




GOTH 1H 




E^D 


$$ 




jkFXSS 




.TYPE 


LOOP.FAJ 


T0 


CONTINUE 




GOTO li? 




END 



Create a program with an indefinite loop. 



Type the program. 



(continued on next page) 
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3.00 
KIL0-C0RE-SECs67 



SET TIME command (Cont) 



Examples (cont) 



.LOAD. L00P> 

Fortran: loqp.f4 

LOADING 

LOOP 2K CORE 

EXIT 

.SET TIME 5^ 

.TIME^ 
5.5? 

KTO-C0RE>SEC«3g 
^START^ 

?TIME LIMIT EXCEEDED 



Compile and load the program, 



Set the time limit to 5 seconds. 

Clear the incremental run time, so that the 
SET TIME command can be checked. 



Start the loop. 

As expected, the time limit was exceeded. 
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|" SET TTY or TTY command] 



Function 



The SET TTY command (or TTY command) declares properties of the terminal line on which the 
command is typed to frhe scanner service. With hardwired TTYs, the system manager can set the 
default conditions, so that this command is usually not needed. However, the user is likely to 
use this command on data sets, where the terminal cannot be predicted. 



Command Formats 



1. SET TTY NO word 

equivalent to TTY NO word 

2. SET TTY word 

equivalent to TTY word 

NO = the argument that determines whether a bit is to be set or cleared. This argu- 
ment is optional . 

word = the various words representing bits that may be modified by this command. The 
words are as follows: 



SET TTY ALTMODE 
SET TTY NO ALTMODE 
SET TTY BLANKS 
SET TTY NO BLANKS 



SET TTY CRLF 
SET TTY NO CRLF 

SET TTY ECHO 



Converts the ALTmode codes of 175 and 176 to the 
ASCII standard escape character 033. 

Restores the individual identity of the codes 175 
and 176. 

Restores multiple carriage return- line feeds and 
form feeds. 

Suppresses blank lines (consecutive carriage return- 
line feeds after the first) and outputs form feeds 
and vertical tabs as 2 carriage return-line feeds'. 
This is used for the display terminal in order to 
prevent the output from moving up off the screen. 

Restores the carriage return. 

The carriage return normally output at the end of a 
line exceeding the carriage width is suppressed. 

Restores the normal echoing of each character 
typed in. 

(continued on next page) 
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SET TTY command (Cont)] 



Command Formats (cont) 

SET TTY NO ECHO 

SET TTY FILL n 
SET TTY NO FILL 



Character 
Name 



BS 

HT 

LF 

VT 

FF 

CR 

XON 

TAPE 

XOFF 

NTAP 



The terminal line has local copy and the computer 
should not echo characters typed in. 
The filler class n is assigned to this terminal. The 
filler character is always DEL (RUBOUT, 377 octal). 
No fillers are supplied for image mode output. 

Equivalent to TTY FILL 0. Fillers for output and 
echoing are determined from the following: 



Octal 



010 

on 

012 
013 
014 
015 
021 
022 
023 
024 



Number of Fillers for Filler Class 




















1 



6 

1 or 2 
6 

6 
21 

2 or 4 
1 

1 
1 
1 



6 

1 or2t 
6 

6 
21 

2 or 4tt 
1 

1 
1 
1 



f 1 if 0-3 spaces to tab stop; 2 If 4-7 spaces to tab stop. 
ttl or 2 if CR is typed; 2 or 4 if CR is supplied because the line is 
too long. _____ 



SET TTY FORM 
SET TTY NO FORM 
SET TTY GAG 

SET TTY NO GAG 
SET TTY LC 



This terminal has hardware FORM (PAGE) and VT 
(vertical tab) characters. 

The monitor sends eight line feeds for a FORM and 
four line feeds for a VT. 

The SEND command cannot be received at this ter- 
minal unless the terminal is at command level 
(initial state). 

The SEND command can be received at this termi- 
nal even though it is not at command level . 

The translation of lower-case characters input to 
upper case is suppressed. 

(continued on next page) 
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J SET TTY command (Cont) 



Command Formats (cont) 

SET TTY NO LC 



SET TTY PAGE 



SET TTY NO PAGE 



SET TTY SLAVE 



SET TTY TAB 
SET TTY NO. TAB 
SET TTY TAPE 

SET TTY NO TAPE 

SET TTY WIDTH n 



The monitor translates lower-case characters to 
upper case as they are received, In either case, 
the echo sent back by the monitor matches the case 
of the characters after translation. By looking at 
the printout, the user can determine what transla- 
tion was performed by the monitor. 

The user has the ability to temporarily suspend sys- 
tem typeout without losing it. The XOFF key (tS) 
suspends the typeout, and the XON key (tQ) re- 
stores it. The XOFF and XON keys are not echoed 
and are not sent to the user's program. This com- 
mand is useful for display terminals where the user 
may want to read a page of text before it disappears 
from the screen. Note that this preempts the use 
of tS and tQ for reading paper tape (see 
SET TTY TAPE). 

The typeout control ability of the XOFF and XON 
keys is disabled. The current interpretation of these 
keys depends on the last SET TTY TAPE command. 

The terminal becomes slaved, i.e., no commands 
may be typed on the terminal, and the terminal may 
be ASSIGNed by another user. The user can slave 
only his own terminal and must contact the operator 
in order to uns lave it. 

This terminal has hardware TAB stops every eight 
columns. 

The monitor simulates TAB output from programs by 
sending the necessary number of SPACE characters. 

The XON key (tQ) causes the terminal to read 
paper tape. The XOFF key (tS) causes the term- 
inal to stop reading paper tape. 

The XON key (Q) and the XOFF key (tS) have no 
special paper tape function. They may have a 
PAGE function. 

The carriage width (the point at which a free car- 
riage return is inserted) is set to n. The range of n 
is 17 (two TAB stops) to 200 decimal. 



5.05 Monitor 
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SET TTY command (Cont) 



Characteristics 



The SET TTY command: 

Leaves the terminal in monitor mode. 

Does not require LOGIN. 

Depends on FTSET which is normally absent in the DECsystem-1040. However, the 

TTY command format can always be used. 
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[ff 



SET WATCH command 



Function 



The SET WATCH command sets the system to print incremental job statistics automatically. 
This command provides the user with a tool for measuring the performance of his programs. 



Command Formats 



1 . SET WATCH ang 1 , arg 2/ . . . ,.arg 5 

prints the specified WATCH statistics. 

2. SET WATCH ALL 

prints all the WATCH statistics. 

3. SET WATCH NONE 

eliminates the printing of all WATCH statistics. 

4. SET WATCH NO arg,, arg 2 ,..., a rg 5 

eliminates the printing of the specified WATCH statistics. 

The following arguments enable printing whenever a monitor command switches the 
console from monitor to user mode. 

arg = DAY prints the time of day, as [HH:MM.SSJ 

arg = VERSION prints the version of the program in standard format 
(refer to the VERSION command). 

The following arguments enable printing whenever the console is returned to monitor 
mode via the TC, EXIT, HALT, ERROR IN JOB n, or DEVICE xxx OPR zz ACTION 
REQUESTED messages. 

ar 9 = R EAD prints the incremental number of disk blocks read modulo 4096. 
arg = RUN prints the incremental run time. 

arg = WAIT prints the wait time (time elapsed since the user started or contin- 
ued the program). 

arg = WRITE prints the incremental number of disk blocks written modulo 4096. 
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SET WATCH command (Cont) 



Command Formats (cont) 



Any combination of the arguments may be spec.f.ed m any order. Statist, cs are ntf 
printed for commands that do not run programs, such as ASSIGN or PJOB When a 
user logs in, his job is set to WATCH the statistics of which he has notified 1 the system 
manager. The information on what statistics to WATCH is kept in ACCT.SY5. 

The order of the error message is the same as the order of output. Therefore, a user 
who forgets either the argument or the significance of the statistics can find these out 
by examining the message. A single space is always typed between each statistic, 
whether the statistic appears or not; therefore, it is. possible to tell which statistics 

are being typed. 

NOTE 

Enabling WATCH output interacts with the incremental 
data typed by the TIME and DSK commands. 



Characteristics 

The SET WATCH command: 



Leaves the terminal in monitor mode. 

Depends on FTSET and FTWATCH which are normally absent in the DECsystem- IUW. 



Associated Messages 



Refer to Chapter 4. 
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[SET WATCH command (Cont)l 



Examples 

1. .SET WATCH Pj 

! A il£ S _^lEj_[)AY .H U N,WAIT J ,KEA D,WkITE,VEKS ION, ALL, NONE 

^SET WATCH^) 

?ARBS AR Q J^AYyJtUN^W A IT, READ, WK ITE, VERS ION, ALL, N ONF 

^SET WATCH DAY KUN WAIT READ WKITF 

•K PIPj 
C2P ; 3 8 ; 1 9 3 

*tC 

C6.10 2.95 4 57 243 3 

2. : SET WATCH VERSION DAY^ 

•R TECO^ 
C9;44:303 

CSlTECO 22(64 ) + 3 
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SKIP command 1 



Function 

The SKIP command spaces a magnetic tape forward a specified number of files or records or to 
the logical end of tape. This command, depending on its arguments, is equivalent to the 
following PIP command strings: 

MTAn: (M # nA) - 
MTAn: (M #nD) - 
MTAn: (M # nT) - 

Command Formats 

1. SKIP MTAn: x FILES 

advances forward x files. 

2. SKIP MTAn: x RECORDS 

advances forward x records. 

3. SKIP MTAn: EOT 

advances forward to the logical end of tape. 
The words FILES, RECORDS, and EOT can be abbreviated to F, R, and E, respectively. 

Characteristics 

The SKIP command: 

Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 

Associated Messages 

Refer to Chapter 4. 



^his command runs the COM PI L program, which interprets the command before running the PIP program. 
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SKIF> command (Cont) 



Examples 



^SKIP KTA0: A PILES ) 

•_SKIP MAI 3 E.01 ) 

^SKIP N'TAgJ 20 KFCOKDS^ 



Version 20 COM PI L 
Version 32 PIP 
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SSAVE command 



rccT] 



Function 

The SSAVE command is the same as the SAVE command except that the high segment, if present, 
will be sharable when it is loaded with the GET command. To indicate this sharab.hty, the 
high segment is written with extension .SHR instead of .HGH. A subsequent GET will cause 
the high segment to be sharable. Because an error message is not given if the program does 
not have a high segment, a user can use this command to save system programs without having 
to know which are sharable. 

On magnetic tape, if the low or high segment is missing, a null record is output before the 
EOF for the missing segment so that two EOFs cannot occur consecutively. Therefore, a saved 
null segment does not appear as a logical EOT (2 EOFs in a row). 

The SAVE command rather than the SSAVE command, should be used when debugging the pro- 
gram This is because a GET command after a SSAVE command does not reinitialize the 
original high segment from the file after the user modifies it with the D command or the DDT 
program. Refer to Appendix D for more information on the SSAVE command. 

Command Format 

SSAVE devrfile.ext [proj, prog] core 

Arguments and defaults are the same as in the SAVE command. * 

Characteristics 

The SSAVE command: 

Leaves the terminal in monitor mode. 

Requires core. 

Does not operate when a device is currently transmitting data. 

Associated Messages 

Refer to Chapter 4. 

Example 

.SSAVE DSKMEST^ 
JOB SAVED 



(continued on next page) 
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ISSAVE command (Cont) 



Example (Cont) 



.LOAD FILE1*) 
mCRO; FILE 1 
LOADING "~ 



Compile and load program. 



LOADER IK CORE 
EXIT 



.SSAVE^ 
JOB SAVED 

• GETj 
JOB SETUP 



Save a sharable copy. The filename is taken from 
the routine that contained the starting address. 

Get a sharable copy. 
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START command! 



Function 



The START command begins execution of a program either previously loaded with the GET com- 
mand or interrupted (e.g., tC), The old program counter is copied from JBPCto JBO PC 
An explicit start address is optional, and, if omitted, the address supplied ,n_the , f. le (. JBSA) 
is used If an address argument is specified and the job was executing a UUO when mterrupted 
(i e it was in exec mode but not in TT.Y input wait or SLEEP mode), the monitor sets astatus 
bit (UTRP) and continues the job at the location at which it was interrupted before trapping to 
the specified START address. When the UUO processing is completed, the mo " ! tor clwrs the 
status bit sets . JBOPC to' the address following the UUO, and then traps to the START address. 
If the job is in TTY input wait or SLEEP mode, the trap to the program occurs immediately, _and 
.JBOPC contains the address of the UUO. If the job is in user mode, the trap also occurs .m- 
mediately. 



Command Format 



START adr 



adr = the address at which execution is to begin if other than the location specified 
within the file (.JBSA). This argument is optional. If adr is not specified, the address 
comes from .JBSA. A starting address of may be specified. 



Characteristics 



The START command: 



Places the terminal in user mode. 

Does not operate when a device is currently transmitting data. 

Requires core. 

Requires LOGIN if an address argument is specified. 



Associated Messages 

Refer to Chapter 4. 

Example 

.START„> 
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I SUBMIT command ] 



Func tion 

The SUBMIT command is used to place entries into the input queue for the Batch system This 
command is equivalent to the following form of the QUEUE command: 

QUEUE INP: jobname = control file, log file 

Command Format 

SUBMIT jobname = control file, log file 

jobname = name of the job being entered into the queue. 

control file = name of the control file. This file contains all monitor-level and user- 
level commands for processing by the Batch Controller (BATCON). 

log file = name of the log file. This file is used by the Batch Controller to record its 
processing of the job. 

Only the two files mentioned above can be specified in a request to the Batch input queue 
The name of the control file is required; the log file name is optional and, if omitted, is taken 
from the control file. If the jobname is ommited, it is the name of the first file in the request 
not the name of the first file given. If an extension is omitted, the following are assumed: ' 

. CTL for the control file 
.LOG for the log file. 

Three categories of switches can be used in the command string: 

1 . Queue-operation - Only one of these switches can be placed in the command 

string , because they define the type of queue request. The switch used can appear 
anywhere in the command string. 

2. General - Each switch in this category can appear only once in the command string 
because they affect the entire request. The switch used can appear anywhere in 
the command string. 

3. File control - Any number of these switches can appear in the command string be- 
cause they are specific to individual files within the request. The switch used 
must be adjacent to the file to which it applies. If the switch precedes the file- 
name, it becomes the default for subsequent files. 
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SUBMIT command (Cont) 



Command Format (cont) 



The following 
Switch 



/AFTERitt 



/CARDS :n 



/CORE:n 



/CREATE 
/DEADLINES 



/DEPEND:n 



switches can be used with the SUBMIT command. 
Explanation 

Process the request after the specified time; tt is either 
in the form of hhmm (time of day) or +hhmm (time later 
than the current time). The resulting AFTER time must 
be less than the DEADLINE time. If the switch, or the 
value of the switch, is omitted, no AFTER constraints 
are assumed. 

Use n (decimal) as the maximum number of cards that 
can be punched by the job. If the switch is omitted, 
no cards are punched. If the switch is given with no 
value, 2000 cards is assumed as the default. 

Use n (decimal K) as the maximum amount of core 
memory that the job can use. If the switch is omit- 
ted, 25K is the maximum. If the switch is specified, 
but the value is omitted, the default maximum is 
40K. 

Make a new entry into the Batch input queue. This 
switch is the default for the queue-operation switches. 

Process the request before the specified time; tt is 
either in the form hhmm (time of day) or +hhmm 
(time later than the current time). The resulting 
DEADLINE time must be greater than the AFTER ^ 
time. If the switch, or the value of the switch, is 
omitted, no DEADLINE constraints are assumed. 

Specify the initial value of the dependency count 
(in decimal). When used with /MODIFY, this 
switch changes the dependency count of another 
job. If n is a signed number (+ or -), that number 
is added to or subtracted from the dependent job's 
count. If n is not a signed number, the dependent 
job's count is changed to n. If this switch is omit- 
ted, no dependency is assumed. 



/DISPOSErDELETE Delete the file after processing. 



Category 



General 



General 



General 



Queue Operation 



General 



General 



File Control 



(continued on next page) 
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JSUBMIT command (Cont) | 



C ommand Format (cont) 

Switch 
/DISPOSErPRESERVE 



/DISPOSE :RENAME 



/F 



/FEET:n 

/KILL 

/LIST 
/MODIFY 



/NEW 



Explanation 

Save the file after processing. This is the default for 
all files except those with extensions .TMP LST 
.CDP, .LPT, .PILT, and .PTP. ' 

Rename the file from the specified directory imme- 
diately, remove it from the logged-out quota, and 
delete it after processing. This is the default for 
files with extensions .TMP, .LST, .CDP LPT 
. FIT, and . PTP. ' ' ' 

List the entries in the input queue, but do not update 
the queues. Therefore, the list may not be an up-to- 
date listing, but the listing will be faster than with 

Use n (decimal) as the maximum number of feet of 
paper tape that the job can punch. If the switch is 
omitted, no paper tape is punched. If the value is 
omitted, the default is 10*B+20feet, where B is 
the number of blocks in the request. 

Remove the specified entry from the Batch input 
queue. This switch can be used for deleting a 
previously-submitted request as long as the request 
has not been started by the Batch Control ler. 

List the entries in the input queue; the default is all 
entries for all jobs of all users. 

Alter the specified parameters in the job. This switch 
requires that the user have access rights to the job. 
It can be used for altering a previously submitted re- 
quest as long as the request has not been started by the 
Batch Controller. 

Accept the request although the file does not yet 
exist. This is the default for the log file. When 
facing this switch with the control file, the user 
can submit his job and then create the control file. 



Category 
File Control 

File Control 



Queue Operation 



General 



Queue Operation 

Queue Operation 
Queue Operation 

File Control 



(continued on next page) 
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SUBMIT command (Corvt)] 



Command Format (cont) 



Switch 



/OUT PUT :n 



/PAGErn 

/PHYSICAL 
/PRIORITY :n 

/PROTECT :nnn 
/RESTART :0 or 1 

/SEQ:n 



Explanation 

Cause job to terminate with a /Z:n to KJOB (n is 

from to 4). 

N=0 Suppress all normal queuing performed at 
LOGOUT time. 

N=l Queue only the log file. 

N=2 Queue only the log file and spooled out- 
put (e.g., *.LPT). 

N=3 Queue the log file, spooled output, and 
*.LST files. 

N=4 Queue the log fi le, spooled output, 

*.LST files, and any requests deferred to 
LOGOUT time (default). 

Use n (decimal) as the maximum number of pages of 
output that the fob can print. If the entire switch 
is omitted, the maximum is 200 pages; if only the 
value is omitted, the maximum is 2000 pages. 

Suppress logical device name assignments for the 

device specified. 

Assign the specified external priority (n=0 to 62) 

to the request. The larger the number, the greater 

priority the job has. The default is 10 if no switch 

is given and 20 if the switch is specified without a 

value. 

Assign the protection nnn (octal) to the job. If the 
switch, or the value of the switch, is omitted, the 
standard protection is assumed. 

A value, of means the job is not requeued or re- 
started by the Batch Controller .after a system crash 
(default). A message is sent to the job's log file. 
A value of 1 means the job is restarted by the Batch 
Controller. 

Specify a sequence number to help in identifying 
a request to be modified or deleted. 



Category 



General 



General 

File Control 
General 



General 



General 



General 



(continued on next page) 
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[JJJBMIT command (Cont) 



Command Format (cont) 



Switch 
/STARTrn 

/START scxx 
/TIMEjhhmmss 

/TPLOT:n 



/UNIQUErO or 1 



Explanation Category 

Begin on the nth line of the control file. If the File Control 

switch, or the value of the switch, is omitted, the 
Batch Controller starts with the first line. 

Start at the statement labelled xxx (up to 5 characters) File Control 
of the control file. 

Specify the central processor time limit for the job. If General 
no switch is specified, the limit is 5 minutes; if the 
switch is given without a value, the limit is 1 hour. 

Use n (decimal minutes) as the maximum amount of General 

plotting time allowed for the job. If the switch is 
omitted, no plotter time is allowed; if the value is 
omitted, but the switch is given, the maximum is 
10 minutes. 

Run any number of Batch jobs under this project- General 

programmer number at the same time, if 0. Run 
only one Batch job at any one time, if 1 (default). 



Characteristics 

The SUBMIT command: 



Leaves the terminal in monitor mode. 

Runs the QUEUE program. 

Depends on FTQCOM which is normally absent in the DECsystem-1040. 



Associated Message s 

Refer to Chapter 4. 
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SUBMIT command (Cont) 



Examples 



.SUBMIT USRJ0B*C0MTRL,L0GFIL^ 
The defaults are as follows: 



1. control file name is CONTRL.CTL 

2. log file name is LOGFIL.LOG 

3. no cards punched (/CARDS :0) 

4. maximum core of 25K (/CORE:25) 

5. no dependency (/DEPEND*)) 

6. control and log files are saved after spooling (/DISPOSE:PRESERVE) 

7. no paper tape punched (/FEET:0) 

8. all line printer output is spooled with the maximum pages being 200 
(/OUT PUT :4, /PAGE -200) 

9. priority is 10 C/PRIORITYrlO) 

10. standard protection is assumed (/PROTECT:nnn (standard)) 

11. job is not restarted after a crash (/RESTART:0) 

12. control file is begun on the first line (/STARTrl) 

13. maximum CPU time is 5 minutes (/TIME:0:05) 

14. no plotter time allowed (/T PLOT :0) 

15. only one job at a time under a given project-programmer number is run 
(UNIQUE:!), 

.SUBMIT U8RJ0B«/M0DIFY/FEETI35/-C0RE> 

Modify the original request to include 35 feet as the maximum number of feet of paper 
tape that the job can punch and 40K of core as the maximum amount of core that the 
job can use. This command is valid only if the job has not been started yet by the 
Batch system. 

.SUBMIT USRJQB*/KILLJ 

Kill the job only if it has not been started by the Batch system. 



Version 3 QUEUE 



2-223 



COMMANDS -686- 



[SYSTAT command] 



Function 



The SYSTAT command runs a system program which prints status information about the system. 
This information allows a user to determine the load on the system before logging-in. 

To write the output on the disk as a file with name SYSTAT.TXT, assign device DSK with 
logical name SYSTAT. 

The SYSTAT command types the status of the system: system name, time of day, date, uptime, 
percent null time (idle plus lost time), number of jobs in use. 

It types the status of each job logged-in: job number; project-programmer number (**,** = 
detached, [OPR] = the project-programmer number of the operator, [SELF] = user's project- 
programmer number); terminal line number (CTY = console terminal, DET = detached, Pn = PTY 
number); program name being run; program size; job and swapped state (refer to DECs'ystem-10 
Monitor Calls ); run time since logged-in. ~ 

It types the status of high segments being used: name (PRIV = nonsharable, OBS = superseded)- 
device or file structure name from which the segment came; directory name (**,** if detached')- 
S ] Z f ™J swa PP ed out ' SWF = swapped out and fragmented, F = in core and fragmented on 
disk, SPY = user is executing the SPY UUO); number of users in core or on the disk. 

The command types swapping space used, virtual core used, swapping ratio, active swapping 
ratio, virtual core saved by sharing, average job size. 

l7r y T P ^!:, StahJS ° f buSy devIces: device na "ie, job number, how device is assigned (AS = 
ASSIGN command, INIT = INIT or OPEN UUO, AS+INIT = both ways). 

It types system file structures: free blocks, mount count, single-access job. 

It types remote stations: number of station, status of station. 

It types dataset control: number of the TTY, status of TTY. 
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SYSTAT command (Cont) 



Command Format 



SYSTAT arg 



arg = one or more single letters (in any order) used to type any subset of the SYSTAT 
output. This argument is optional . The following message, produced by typing 
SYSTAT /H, lists the various arguments to the SYSTAT command. 



•SYSTAT/H^ 

SYSTAT V467(5> 

SYSTAT INSTKUCTIONS: 

TYPE ,, SYS<C.RET.>" TO LIST THE ENTIRE STATUS* OK 

TYPE "SYS " FOLLOWED BY ONE OR MORE LETTERS AS FOLLOWS-- 

B BUSY DEVICE STATUS 

D DORMANT SEGMENT STATUS .. 

E NON-DISK ERROR REPORT 

F FILE STRUCTURE STATUS 

H THIS MESSAGE 

J JOB STATUS 

L OUTPUT TO LPT 

N NON-JOB STATUS (ALL BUT J) 

OTHER SYSTEM STATUS 

P DISK PERFORMANCE 

R REMOTE STATION STATUS 

S SHORT JOB STATUS 

T DATASET STATUS 

X READ DSK:CRASH.XPN 

NNN PRINTS Just JOB NNN (. DOES THIS JOB) 

CP,PN3 PRINTS JUST JOBS WITH THAT PROJ-PROG (P AND/OR PN MAY BE *) 

#NNN PRINTS JUST JOBS FROM TERMINAL NNN 

(ALSO* C=CTY, PNN=PTYNN» TNN=TTYNN* . -THIS TTY> 



Characteristics 



The SYSTAT command: 

Leaves the terminal in monitor mode. 

Runs the SYSTAT program, thereby destroying the user's core image. 

Does not require LOGIN. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 
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SYSTAT command (Cont) 



Examples 



^5iSTAlJ 

Si AT US OF B50400-0 5 #40. Af 



6:15:17 ON 11 -APH-72 



UPTIfcE 7:00:59* 108% MULL IlfcE = 105% IDLE + 3% LOST 
5J J065 IN USE Go T OF 64. 50 LOGGED IN, 2 DETACHED 



JOB 


WHO 


LINE* 


WHAT 


5 I ZE C K > 


STATE 


HUN TIME 


1 


COPrU 


LET 


DAEKON 


5 +SP Y 


SL SW 


20 


2 


40,64 


131 


TECO 


2+3 


»C SW 


7 


3 


COPHD 


2 


OPS EH 


1 +3 


HB SW 


3:43 


4 


COPH3 


4 


UfOUNT 


2+3 


»C SW 


3:38 


5 


2,111 


3 


PIP 


1 +4 


tC SW 


26 


6 


274,1431 


60 


COB DDT 


14+8 


RN 


12 fl5 


7 


CGPtO 


CTY 


P.IP 


1 +4 


tC SW 


4 3 


a 


16,35 


20 ' 


FDSi'S 


22 


TI SW 


1:37 


9 


347,1246 


65 


PIP 


1 +4 


tC SW 


5 


10 


271,1 131 


64 


QUEUE 


2+4 


tC SW 


29 


1 1 


C OPr< 3 


P0 


BATCON 


2+3 


HN 


2:45 


12 


2 71,701 


61 


SEEK 


2+a 


II S W 


5:08 


13 


33 7,1 1 13 


1 14 


KJOB 


1 +3 


tC SW 


13 


14 


40,64 


150 


TECO 


2+3 


Tl SW 


4:3 7 


1 5 


122,216 


124 


KJOB 


1 +4 


CB 


2 


16 


16,107 


P2 


SYSTAT 


6+SPY 


SL SW 


25 


1 7 


142,1243 


62 


TECO 


2+3 


TI 


1 :00 


18 


146,500 


1 12 


TECO 


2+3 


TI 


2:09 


19 


40,65 


1 4 7 


EDITS 


2+6 


TI SW 


1 :24 


20 


240,353 


155 


TEC 


2+3 


TI SW 


1 


21 


COPHJ 


PI 


LP TS PL- 


2 


10 


13:47 


22 


345,141 7 


74 


ED ITS 


2+6 


tC SW 


43 


23 


COPHD 


P3 


LPTSPL 


2 


10 


18:39 


24 


COPHD 


P4 


PTPSPL 


2+3 


HB SW 


1 :25 


25 


COPriD 


1 


OPS EH 


1+3 


HB SW 


46 


26 


COPHD 


P6 


OPrfOfrO 


2+5 


TI SW 


1 :38 


2 7 


COPHD 


P5 


OPHOKO 


2+5 


SL SW 


1 :31 


28 


360,1436 


137 


UKOUNT 


2+3 


CB 


1 :01 


29 


125,207 


15 


EDITS 


2+6 


TI SW 


1 


30 


1 10,1412 


127 


TECO 


2+3 


DI 


7 


31 


402,570 


12 


PIP 


1 +4 


CB SW 


1 :26 


32 


405,505 


25 


PIP 


1+4 


TC SW 


1 :13 


33 


40,633 


146 


TECO 


2+3 


TI 


5:33 


34 


2/1,701 


14 


SEEK 


2+8 


TI SW 


4 


35 


10,20 


142 


D 


13+34 


TI 


33:14 


36 


413,521 


21 


TECO 


2+3 


TI 


20 


3 7 


402,5 70 


P7 


DCTDE 


4 


TC SW 


12 
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SYSTAT command (Cont) 



Examples (cont) 



38 122 


,1202 


136 


EDITS 


2+6 


TI 


SW 


3 9 60 


,60 


153 


TECO 


2+3 


TO 




40 40 6 


,104 


35 


PLEASE 


1 


SL 


SW 


41 402 


,574 


36 


SPACE 


2 


TI 


SW 


42 271 


,701 


30 


RAFCO* 


6+8 


TI 




43 14 


,1 145 


P10 


UfrOUNT 


2+3 


SL 


SW 


44 14 


,1 145 


11 


DIRECT 


1+3 


tC 


SW 


45 2 


,5 


135 


QUEUE 


3+3 


CB 


SW 


46 1 1 


,176 


144 


COfcPCT 


5 


TO 




4 7 10 


,33 


DET 


UfrOUNT 


2+3 


TO 


SW 


48 10 


,34 


6 


TECO 


4+3 


TI 




49 2 


,5 


13 


SYSTAT 


6+SPY 


RN 




50 1 10 


,1367 


157 


TECO 


2+3 


TI 


SW 


51 340 


,110 7 


26 


AID 


2+9 


RN 


SW 


52 2 


,5 


7 


SYSTAT 


4 


CB 




53 122 


,1007 


122 


TECO 


2+3 


TI 


SW 


. ^NN CGttREbPONDb 


TO TTY172+NN 








HIGH SEGMENTS: 






- 






PrtOGrtAK- 


DEVICE 


W NEK 


HIGH(K) 


USERS 






OPbEK 


DbKB 


S*S 


3 SW 


2 






DIRECT 


DbKB 


SYS 


3 SW 


1 






Ur^ANGri 


DbKB 


SYb 


3 


2 






PIP 


PS KB 


bYb 


4 SW 


5 






TECO 


DbKB 


SYS 


3 


12 






ED lib 


DbKB 


SYS 


6 SW 


4 






( Prt I V > 




JOB 3 5 


34 


1 






UUEUE 


DbKB 


bYb 


4 


2 






LIBOL 


DbKB 


bYb 


8 


4 






OfrOUNT 


DbKB 


bYb 


■ 5 SW 


2 






PTPbPL 


DbKB 


SYS 


3 SW 


1 






UKOJNT 


DbKB 


SYS 


3 


4 






KJOB 


DbKB 


SYS 


3 SW 


1 






AID 


DbKB 


SYS 


9 SW 


1 







1 

6:33 

3 

10 

2:11 

1 

45 



2:16 

1 

3:02 



16 

1 



24 



SWAPPING SPACE USED\= 156/635 = 25% 

VIRT. CORE USED = 254/635 = 40% 

SWAPPING RATIO = 254/144 = 1-8 

ACTIVE SWAPPING RATIO = 75/144 =■ 0.5 

VIRT. CORE SAVED BY SHARING = 1 1 5/C 1 1 5 +254 ) = 31% 

AVERAGE JOB SIZE = 163/53 = 3.1 + 206/53 = 3.-9 TOTAL 



= 369/53 = 7.0 



(continued on next page) 
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SYSTAT command (Cont) 



Examples (cont) 



BUSY DEVICES: 




DEVICE 


JOB 


WHY LOGICAL 


LFT0 


23 


AS+INIT 


LPT1 


21 


AS+INIT 


DTA1 


14 


AS 


DIA2 


19 


AS 


DTA3 


33 


AS 


DTA4 


7 


AS 


DTA6 


2 7 


AS+INIT 


D1A7 


26 


AS+INIT 


MTA1 


37 


AS 


MA2 


35 


AS 


MTA3 


31 


AS 


PTP0 


24 


INIT 


72 DISK 


DDBS 




SYSTEfc 


KILE SThUCTUHES: 


NAfcE 


KHEE 


fcOUNT 


DSKA 


705 


12 


DSKB 


17226) 


54 


DSKC 


35895 


5 


DIA(j 


2b35 


3 



TOTAL FrtEE 56655 

DATASET CONTHOL 
TT*# STATUS 



60 
61 
62 
64 
65 
72 
74 



IN USE 
IN USE 
IN USE 
IN USE 
IN USE 
IN USE 
IN USE 



KJOB 



(continued on next page) 
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SYSTAT command (Cont) 



Examples (cont) 



^SYSTAT P J 

STATUS OF B50400-05 #40 AT 16:27:49 ON 1 1 -APR-72 



XH 



XW 



MR 



MW 



DISK PERFORMANCE STATISTICS: 
UNIT OK F/S 

BR BW DK DW 

DSKA 716 FKEE 

FHA1C1HD002) : 716 FREE, SEEKS 

6616 177 59861 8811 30062 27935 

ErtrtOrtS: 1DAT.-1 RETHIESil 2C0NI -.4000 , 1 5 1 CONI :4000 ,40 1 5 2DATAI:21 1DATAI 
:140071 

DSKB 17215 FREE 

DPA0C 102446): 4445 FREE* 54617 SEEKS ,„.„ n 

» 30498 39483 12648 1155 41622 10489 

MSB ERRORS: 1 DAT: 11 RETRIES :1 2C0NI:15 1CONI:5,4015 2DATA I :54661 ,40000 
1 DATA I : 54 66 1, 40000 
DPA1C 117986): 4345 FREE, 42791 SEEKS 

37609 41724 17037 2790 20563 9505 

MSB ErtrtORS: 1DEV:8 1DAT:240 RETRIES:! 2C0NU15 1CONI:5,4015 2DATAIM02 
261,240000 1DATAI :102261 ,240000 
DPA2C 102376): 4170 FREE, 33215 SEEKS 

35205 35413 -14911 1236 15503 7687 

MSB 
DPA4C 102490): 4310 FREE, 32078 SEEKS 

38472 32920 12599 2215 9711 5934 

MSB ERROKS: 1DEV:6 RETRIES:3 2C0NIM5 1CONI:40015 2DATAI :456661 ,400000 
1DATAI :45666T ,0 
DSKC 35925 FREE 

DPA5C 151669): 35925 FREE, 2863 SEEKS 
1705 337 250 1 

MSB 
DIAC 2945 FREE 

DPA6CDIAG01 ): 2945 FREE, 6808 SEEKS 

2133 2532 8423 533 8199 

MSB 

ACTIVE SWAPPING STATISTICS: 
UNIT H W USED(K) 

FHA0 809992 366056 281/335 = 84% 

FHA1 397720 351376 181/300 = 60% 











4236 



1014 



2602 



. KUOB 
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SYSTAT command (Cont) 



Examples (Cont) 



A SYS 


110,*] J 










SYSTAT V467(5) 










10 


[SELF] 


in 


SYSTAT 


5tSPY 


PN 


14 


IP. 133 





TFCO 


2 + 3 


TI 



3 
47 



A SYS /Qj 
SYSTAT V467C5) 

STATUS OF 50416A SYSTFM *p AT 18 16 8 11 P.M. ON 24-FEB-72 

UPTIME 45:47, 60% NULL TIME ■ 55% IDLE + 5% LOST 
15 JOBS IN USE OUT OF 37. 15 LOGGED IN, 1 DETACHED 

SWAPPING SPACE USED = 6«/350 ■ 19% 

VIRT. CORE USED « 85/350 * 24% 

SWAPPING RATIO ■ 85/18 8 4.7 

ACTIVE SWAPPING RATIO » 5/18 ■ . 3 

VIRT. CORE SAVED BY -SHARING ■ 5/C5+85) ■ 6% 

AVERAGE JOB SXZE * 49/15 » 3.3 ♦ 41/15 « 2,7 TOTAL ■ 90/15 ■ 6.0 
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TECO command 



n 



Function 

The TECO command runs TECO and opens an already existing file on disk for editing. 
Refer to the TECO manual in the DECsystem-10 Software Notebooks. 

Command Format 

TECO dev :f i le . ext [proj , prog] 

dev: = the device or file structure name containing the existing file. If omitted, DSK: 
is assumed. 

file. ext = the filename and filename extension of the existing file. If omitted, the 
arguments of the last EDLT-class command are used. 

[proj, prog] = the directory name in which the file appears. If omitted, the user's 
directory is assumed. 

Characteristics 

The TECO command: 

Places the terminal in user mode. 

Runs the TECO program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 

Associated Messages 

Refer to Chapter 4. 

Example 

jJECO TEST1 .MAC J 

*tC 

.TECO DSKBtFILNAM.CBL C100>273 - ) 



Hhis command runs the COMPIL program, which interprets the commands before running TECO. 

Version 20 COMPIL 
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TIME command 



Function 



The TIME command causes typeout of the total running time since the last TIME command, fol- 
lowed by the total running time used by the job since it was initialized (logged-in), followed 
by the integrated product of running time and core size (KILO-CORE-SEC=). Time is typed in 
the following format: 

hh:mm:ss.hh 

where 

hh = hours 

mm = minutes 

ss.hh = seconds to nearest hundredth. 

Interrupt level and job scheduling times are charged to the user who was running when the 
interrupt or rescheduling occurred. 

NOTE 

If automatic runtime is enabled using the SET WATCH 
command, the incremental runtime is usually 0. 



Command Format 



TIME fob 



job = the job number of the job whose timing is desired. If job is omitted, the job to 
which the terminal is attached is assumed. In this case, monitor types out the incre- 
mental running time (running time since last TIME command) as well as the total run- 
ning time since the job was initialized. 



Characteristics 



The TIME command: 



Leaves the terminal in monitor mode. 
Does not require LOGIN. 



Associated Messages 

Refer to Chapter 4. 
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TIME command (Cont) 



Example 



.time,; 




F.38 




0.38 




KIL0«C0RE-SEC»1 


.ti; 




0,00! 




0.38 




KIL0-C0RE-SFC«1 


J3IR/FJ 




NEW505 


BAK 


NEW505 


RNO 


F00 


SFD 


C ' 


MAC 


PETALS 


F4 


PETALS 


SAV 


CSHELL 


MAC 


CIO 


MAC 


TRYCIO 


MAC 


METER 


RNO 


SURFIT 


AUG 



The command is given for the first time after LOGIN; 
therefore, the incremental time equals the total 
time since LOGIN. 



OSKB: 



DSKC: 



[10,770] 



.TI^ 
0.40 
0.78 
KILO- 



The DIRECT command took .40 seconds of runtime 
and 5 kilo-core-seconds. 



C0RS-SEC«6 
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TPUNCH command 



Function 



The TPUNCH command is used to place entries into the paper-tape punch output queue. This 
command is equivalent to the following form of the QUEUE command: 

QUEUE PTP: jobname = list of input specifications. 

The TPUNCH command can be further abbreviated to 
PUNCH jobname = list of input specifications. 

However, individual installations may redefine PUNCH to mean output to the card-punch 
queue instead of the paper-tape punch queue. 



Command Format 



TPUNCH jobname = list of input specifications 

jobname = name of the job being entered into the queue. The default is the name of 
the first file in the request not the name of the first file given. These differ when the 
first file given does not yet exist. 

input specifications = a single file specification or a string of file specifications, 
separated by commas, for the disk files being processed. A file specification is in the 
form dev:file.ext [pro j, prog]. 

dev: = any file structure to which PTPSPLwill have access; the default is DSK:. 

file. ex t = names of the files. The filename is optional. The default for the first file- 
name is *, the default for subsequent files is the last filename used. The extension can 
be omitted; the default is .PTP. 

[proj,prog] = a directory to which the user has access; the user's directory is assumed if 
none is specif ed. 

The wildcard construction can be used for the input specifications. 

If no arguments appear in the command string (i.e., only the command name is given), all 
entries in the paper-tape punch queue for all jobs are listed. 

Switches that aid in constructing the queue entry can also appear as part of the input specifi- 
cations. These switches are divided into three categories: 

1. Queue-operation - Only one of these switches can be placed in the command 

string because they define the type of queue request. The switch used can appear 
anywhere in the command string. 

(continued on next page) 
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TPUNCH command (Cont) | 



Command Format (cont) 



2 General - Each switch in this category can appear only once in the command 
string because they affect the entire request. The switch used can appear any- 
where in the command string. 



3. 

The follow 
Switch 



/AFTERrtt 



/BEFORE* 
/BEGIN :n 
/COPIES :n 

/CREATE 
/DEAD LIN E:tt 



General 



File control - Any number of these switches can appear in the command string 
because they are specific to individual files within the request. The switch used 
must be adjacent to the file to which it applies. If the switch precedes the file- 
name, it becomes the default for subsequent files. 

ing switches can be used with the TPUNCH command. 

Explanation Category 

Process the request after the specified time; tt Is either 
in the form of hhmm (time of day) or +hhmm (time later 
than the current time). The resulting AFTER time must 
be less than the DEADLINE time. If the switch, or the 
value of the switch, is omitted, no AFTER constraints 
are assumed. 

Queue only the files with a creation date before 
time t where t is in the form dd-mmm-yy. 

Start the output on the nth foot of tape. The default 
is to begin output on the first foot. 

Repeat the output the specified number of times. N 
must be less than 64. If more than 63 copies are 
needed, two separate requests must be made. If this 
switch is omitted, one copy is made. 

Make a new entry into the paper-tape output queue. 
This switch is the default for the queue-operation 
switches. 

Process the request before the specified time; tt is 
either in the form hhmm (time of day) or +hhmm 
(time later than the current time). The resulting 
DEADLINE time must be greater than the AFTER 
time. If the switch, or the value of the switch, is 
omitted, no DEADLINE constraints are assumed. 

(continued on next page) 



General 
File Control 
File Control 

Queue Operation 
General 
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pTPUNCH command (Contfl 



Command Format (cont) 



Switch 
/DISPOSE:DELETE 
/DISPOSErPRESERVE 

/DISPOSE rRENAME 



/F 

/FILErASQI 

/FILE:ELEVEN 

/KILL 



Explanation 
Delete the file after spooling. 

Save the file after spooling. This is the default 
of all files except files with extensions of . LST, 
."IMP, and if the protection is Oxx, . PTP. 

Rename the file from the specified directory im- 
mediately, remove it from the logged-out quota, 
ar,d delete it after spooling. If omitted, this 
is the default for files with extensions . LST, 
.TMP, and if the protection is Oxx, .PTP. 

List the entries in the paper-tape punch queue, but 
do not update the queues. Therefore, the list may 
not be an up-to-date listing, but the listing will be 
faster than with /LIST. 

Indicate that the file format is ASCII text. This is 
the default. 

Indicate that the file format is MACX11 binary for- 
mat. 

Remove the specified entry from the paper-tape 
punch queue. This switch can be used for deleting 
a previously submitted request as long as the request 
has not been started by the paper-tape punch spooler. 



Category 
File Control 
File Control 

File Control 



Queue Operation 

File Control 
File Control 
Queue Operation 



(continued on next page) 
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TPUNCH command (Cont) 



Command Format (cont) 

Switch 
/LIMIT :n 

/LIST 
/MODIFY 

/NEW 

/NOTE:a 

/NULL 

/OKNONE 

/PHYSICAL 

/PRIORITY :n 

/PROTECTmnn 
/REMOVE 



Explanation 

Limit the output to the specified number of feet. The 
default is 10*B+20 feet, where B is the number of 
blocks in the request. 

List the entries in the paper-tape punch queue; if the 
switch, along with all other switches, is omitted, all 
entries for all fobs of all users are listed. 

Alter the specified parameters in the job. This switch 
requires that the user have access rights to the job. 
It can be used for altering a previously submitted 
request as long as the request has not been started by 
the spooler. 

Accept the request even if the file does not yet exist. 

Punch the specified text (a) in the output. 

Accept the request even if there is nothing in the 
request. No error message is given. 

Do not output message if no files match the wild- 
card construction.' This is assumed at KJOB time. 

Suppress logical device name assignments for the 
device specified. 

Assign the specified external priority (n = to 62) 
to the request. The larger the number, the greater 
priority the job has. The default is 10 if no switch 
is given and 20 if the switch is specified without a 
value. 

Assign the protection nnn (octal) to the job. If the 
switch, or the value of the switch, is omitted, the 
standard protection is assumed. 

Remove the file from the queue. This switch is valid 
dnly with the /MODIFY switch and can be used to 
remove a previously submitted file as long as the 
spooler has not started processing the request. 



Category 



General 



Queue Operation 



Queue Operation 



File Control 
File Control 
General 

File Control 

File Control 

General 



General 



File Control 



(continued on next page) 
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TPUNCH command (Cont) 



Command Format (cont) 



Switch 
/SEQ:n 

/SINCE* 

/START :n 

/STRS 

/TAPErASCII 

/TAPE:BINARY 

/TAIPE:IBINARY 

/TAPE:IMAGE 

/UN PRESERVED 

Characteristics 



Explanation Category 

Specify a sequence number to help identify a request General 

to be modified or deleted. 

Queue only the files with creation dates after the General 

specified time t where t is in the form dd-mmm-yy. 

Begin on the nth line of the file. If the switch, or File Control 

the value of the switch, is omitted, the spooler 
starts with the first line. 

Search for the file on all file structures in the search File Control 

list and take each occurrence. The default is to take 
just the first occurrence. , 

Punch the tape in ASCII code. If the /TAPE switch is File Control 

not specified, the file is punched according to the 
data mode of the file. 

Punch the tape in binary mode. If the /TAPE switch File Control 

is not specified, the file is punched according to the 
data mode of the file. 

Punch the tape in image-binary mode. If the /TAPE File Control 

switch is not specified, the file is punched according 
to the data mode of the file. 

Punch the tape in image mode. If the /TAPE switch File Control 

is not specified, the file is punched according to the 
data mode of the file. 

Output the files only if they are not preserved (i.e., General 

the first digit is 0). This switch avoids redundant 

printing. 



The TPUNCH command: 

Leaves the terminal in monitor mode. 

Runs the QUEUE program, thereby destroying the user's core image. 

Depends on FTQCOM which is normally absent in the DECsystem- 1040. 
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TPUNCH command (Cont) 



Associated Messages 



Refer to Chapter 4. 



Examples 



/TPUNCH TFNDMP.RFL/TAPE:B I NARY/COPIES: 5 J 

Punch 5 copies, in binary mode, of the file DSKrTENDMP.REL. 
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TYPE command 1 



Function 

The TYPE command directs PIP to type the -contents of the named source file(s) on the user's 
terminal. 

To stop the typing, type tC twice. 
Command Format 



TYPE list 



list - a single file specification or a string of file specifications separated by commas. 
The filename is required. The extension is required if the filename has an extension. 

In addition, the full wildcard construction can be used. 

Switches can be passed to PIP by enclosing them in parentheses in the TYPE command 
string. When COMPIL interprets the command string, it passes the switches on to PIP. 



Characteristics 



The TYPE command: 



Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying the user's core area. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 



Associated Messages 

Refer to Chapter 4. 

Examples 



^T YPE F I LEA , DIM: : F I LE!B . tfAC J 
•TYPE *.TMP»DTA*:C^ 



This command runs the COMPIL program, which interprets the command before running PIP. 

Version 20 COMPIL 

Version 32 PIP 2-240 
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UNLOAD command 



3 



Function 

The UNLOAD command rewinds and unloads a magnetic tape or a DECtape. This command is 
equivalent to the following PIP command string: 

| dev:'(MU)- 

Command Format 

UNLOAD dev: 

dev: = a magnetic tape (MTAn) or a DECtape (DTAn). 

Ch aracteristics 

The UNLOAD command: 

Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 

Associ ated Messages 

Refer to Chapter 4. 

Examples 

^UNLOAD DTA7 : ) 
.UNL MTA3 : ) 



Whis command runs the COMPIL program, which interprets the command before running the PIP program. 

Version 20 COMPIL 

Version 32 PIP 2 ~ 241 
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VERSION command 



FuncHon 



The VERSION command prints the version number of the program in the user's core area 

mVFR J aSt m P Mt/ 9 p ram T ! m P l ! ciH y or explicitly). The version number is obtained from 
. JBVfcK and . JBHVR m the |ob data area and is printed in standard format. The output 
trom this command is in one of the following representations: 

low + high The low and high segments are different. 

' ow There is only a low segment. 

low + The. low and high segments are the same. 

+ A GETSMG UUO has been done to a high segment which 

matches the low segment. 

+ high 1 A GETSEG UUO has been done to a high segment which 

does not match the low segment. 

b,ahk T he high segment has been released. 

With the VERSrON command, the low and high segments are represented in the format 
name version 

ont^™™ VERSI ° N ™"' "» ' OW ""* ^ -™* « -P-nted in one 

name version The program is not from SYS: 

:name version 



The output is the result of a SETNAM UUO (e.g. at the 
end of loading). ' 



Smame version 



The program is a system program (not logical device SYS:)» 

i^rxiz™ zzt the version is ln standard w - wh - ^^ *• -io„ 

major version minor version (edit) - group who modified program last 



Output only from the SET WATCH VERSION command. 
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VERSION command (Cont)| 



Function (cont) 



The major version is octal; the minor version is alphabetic; the edit is octal and enclosed m 
parentheses; and the group who last modified the program is octal and preceded by a hyphen 
(0 = DEC development, 1 = all other DEC personnel, and 2-7 = customer use). There are no 
spaces separating the items, and if an item is zero, it does not appear in print. The paren- 
theses and hyphen also do not appear in print if the corresponding item is zero. The following 
are examples of version numbers output in standard format. 



10B(335)-1 



7(5) 



54A 



major version 10, minor version B, edit number 335, 
group that modified program last 1 . 

major version 7, minor version 0, edit number 5, group 
that modified program last 0. 

major version 54, minor version A, edit number 0, group 
that modified program last 0. 



Command Format 
VERSION 

Characteristics 



The VERSION command: 

Leaves the terminal in monitor mode. 

Depends on FTVERS which is normally absent in the DECsystem-1040. 



Examples 



^R TKCOj 
_*tC 

_.VEKSI0N^ 
TECO 22(64) + 

.TYPE SAMPL.TXT^ 
THIS IS A TEXT FILE 

.VERSION^ 
PIP 31(35) + 
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WHERE command 



Function 

The WHERE command enables the user fa determine the station at which a soecific n.ri„h« m l 
dev.ce is located If the station of a particular terminal is requested the numbed ^rned i 
he physical locat.on a. the terminal which may or may not be the location of the carolling 
command " °° ^^ "" "" ^"^ h " i° b ' S ^^ '°«">°" "1th the LOCATE 

Command Format 

WHERE devn 

dev = any physical device name and n is the unit number. 
Characteristics 

The WHERE command: 

Leaves the terminal in monitor mode. 

Does not require LOGIN. 

Depends on FTREM which is normally absent in the DECsystem-1040. 

Assoc iated Messages 

Refer to Chapter 4. 

Examples 

^WHERF CDP2:J 

i ;station of CDR2„ 

..WH TTvg 

2 /station of job's terminal. 



Z WHE HPRiJ 



/station of job issuing command. 



_. WHERE CTY:) 

1 /central station. 
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ZERO command 1 



Function 

The ZERO command clears the directory of the output device. This command is equivalent to 
the following PIP command string: 

dev:/Z~ 

Command Format 

ZERO dev: 

dev: = a DECtape (DTAn) or a disk (DSK). This argument is required. 

A directory name can be specified with ZERO DSK: and if the user has access to the 
specified directory, the directory is zeroed. If no directory is specified, the user's 
directory is assumed. 

Characteristics 

The ZERO command: 

Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying the user's core image. 

Depends on FTCCLX which is normally absent in the DECsystem-1040. 

Associated Messages 

Refer to Chapter 4. 

Examples 

• ZER DTA4 : ) 
^ZERO DSK: ) 
^ZER DSK: [27, 403^ 



This command runs the COMPIL program, which interprets the command before running the PIP program. 

Version 20 COMPIL 

Version 32 PIP 2-245 
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CHAPTER 3 
BATCH SYSTEM COMMANDS 



The Batch System, operating under the control of the DECsystem-10 Operating System, increases sys- 
tem throughput by processing jobs that do not require human interaction. Types of iobs best suited for 
a batch environment are: large and long-running jobs, jobs that require large amounts of data, fre- 
quently run production iobs, and jobs that require little or no interaction with the user. Up to 14 

Batch jobs can be processed concurrently without adversely affecting the running of timesharing jobs. 

Batch jobs may be entered from 

1 . Local devices 

2. Remote devices 

3. Interactive terminals. 

3.1 BATCH COMPONENTS 

The Batch System consists of a group of programs; some are used for Batch operations only, others are 

available for various operations of the total computing system. 

The individual Batch components are: the Stacker, CDRSTK; the Queue Manager, QMANGR; the 
Batch Controller, BATCON; and the output spoolers, LPTSPL (line printer), CDPSPL (card punch), 
PLTSPL (plotter), and PTPSPL (paper-tape punch). 

3.1.1 The Stacker 

The Stacker, CDRSTK, is responsible for 

1 . reading a sequential input stream from an input device, 

2. separating the input by placing it in files according to the control cards contained in the 
input stream, 

3. creating the job's log file and entering a report of its processing, and 

4. entering the job into the Batch input queue. 
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When input Fs from the card reader, CDRSTK accept, ASCII, binary, 026, and DEC-029 Hollerith 
code. (Refer to Appendix B for tables of card codes.) The input is read in image mode, and CDRSTK 
converts it to one of the mentioned codes. If input is from any other device, only ASCII code is 
accepted. 

CDRSTK creates three types of files during its copying of the input data: the user's data files, the 
Batch control file, and the Job's log file. The data files are created according to the control cards 
in the input and are placed into the user's disk area. Programs and data are copied into these files and 
are passed to the job, while it is running, by the Batch Controller. Refer to Paragraph 3.3 for the 
description of the control cards that cause CDRSTK to copy information into these fi les. 

A user control file is created for each valid job and is subsequently processed by the Batch Controller. 
This file contains all monitor level and user level commands encountered in the input. CDRSTK also 
enters commands resulting from the processing of certain control cards and any information that does 
not follow specific control card format. The control file is placed in the user's disk area. Refer 
to Paragraph 3.4 for a description of the Batch Controller commands that can be entered into the con- 
trol file. 

The job's log file contains a report of the CDRSTK's processing, along with a record of any operator 
intervention during its operation. This file is in the user's disk area along with the other CDRSTK- 
created files and is deleted after it is printed by the line printer spooler. 

3. 1.2 The Queue Manager 

The Queue Manager, QMANGR, is the program that schedules fobs and maintains system queues. 
When CDRSTK finishes processing a job, it makes an entry into the Batch input queue. The Queue 
Manager computes and dynamically revises priorities for the job and notifies the Batch Controller when 
the job is to be run. Jobs are scheduled for running according to the parameters pertaining to each 
iob and to the priorities established by the system. While the fob is running, its queue entry is flagged 
to show it is in use, but the entry is not deleted from the queue until the job terminates. When the job 
is logged off the system, an output queue entry is usually made and the entry in the input queue is 
deleted. The Queue Manager again schedules the job's output and deletes the job's output queue 
entry only when the output is completely finished. 

3.1,3 The Batch Controller 

The Batch Cantrcller, BATCON, carols all jab, entered inta the Batch System It reads the central 
file created by CDRSTK ar the user and initiates and centrals the running af the jab by passing data 

and system program commands directly to it. 
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Monitor commands are examined by the Batch Controller and passed to the monitor for ac,ian. The 
Controller determines the destination of commands by interpreting the character in column 1 ,n each 
line of the control file. If column 1 contains a space or a tab, the spaces are i 8 nored until a nonspace 
character is encountered. If column 1 contains an alphabetic or numeric character, the line ,. either 
a. monitor command level or. at user command level. If column I contains a special character, the 
Batch Controller interprets the line as follows: 

$ (dollar sign) - The interpretation depends upon the character in column 2. 

If column 2 contains an alphabetic character, the line is copied to the log file as a com- 
ment because it is a Stacker control line and has already been processed. 
If column 2 contains a numeric or special character, the line is treated as data. 
If column 2 contains a dollar sign ($), the initial dollar sign is suppressed and the line is 
treated as data. 

,f column 2 contains a line feed, vertical tab, ar form feed, a blank line is entered into 
the log file, 
(period) - The interpretation depends upon the character in column 2. 

If column 2 contains an alphabetic character, the line is treated as a monitor command 
v and the period is suppressed. 

If column 2 contains a nonalphabetic character, the line is treated as data with the 
period as part of the data. 

* (asterisk) - The line is treated as a user-level command or program data and the asterisk is 
suppressed. This is the standard input data method for most system programs. 

( „l <lnn) - The line is treated as a user level command or program data. The equal sign is 
^rldl fi^l s^el and the end of the ^J^-^^ -^rT 

the end of the line were passed. 

; (semicolon) - The line is treated as a comment to the log file. 

* (P~cent sign, - The.ine is treated - P- -J^J- £ J^^^T 

Sro, fT is aav^ ^es^N is — red. In this cose, the *HN is executed. 

Refer to the discussion of the .IF command in Paragraph 3.4.5. 

The Batch Controller does no, examine the contents of any lines in the control file other than those 
destined for the monitor. However, when it encounters an up-arraw (.), it converts the up-arrow as 
follows: 

If the character following the up-arrow is a numeric character, the up-arraw and the digit are 

passed to the job. 

■If the character following the up-arrow is an alphabetic .character, £ , op-arrow and the 

character are translated to a control character; e.g., tA ,s translated to CTRL A. 

(continued on next page) 
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L' ~^7 Cter f ° liOWF r 9 the J U P- arrow is ™«t™ -P-c-row, the first up-arrow is ignored and 

U™steaLZ° V ul QS " UP " Qrr ^ •" 9 - ttA JS treated QS tA ("P-™™ A) and 

r t ta is treated as f tA (up-arrow up-arrow A). 

If the job is requesting input and is at monitor level, the control file is read until a command or inter- 
mediate level line is found. If a job is requesting input at data level and the next line Is a monitor 
command, the Batch Controller inserts a control-C. 

A Batch user may no, issue the following monitor commands when his job is operating in batch mode- 
ATTACH, DETACH, CCONT, CSTART, and SEND. If these commands are used, the line is suppressed 
and flagged a. BATERR in the log file and the job is continued. All other monitor commands and 
system program commands may be used by a job operating in batch mode. 

The Botch Controller makes entries to the log file to record its processing of the control file and the 
job. 



3.1.4 The Output Spoolers 

The output spoolers receive job output that has been placed into the output queues by the Queue 
Manager. Usually a job's output is placed in a line printer queue to be printed at a later time by the 
LPTSPL spooling program at the same station from which the input was received. The output filenames 
are in the form QxxSnn. LPT, where xx is a random number, and nn is the station number of the printer 
where the job is currently located. However, the user can also specify other output devices either in 
his programs within his job or by means of the QUEUE monitor command in his job. The first method 
causes output to the card punch, paper-tape punch, or plotter to be automatically spooled by the 
system. The second specifies nonstandard output spooling to any of the spooling devices. 

3.2 SUBMITTING JOBS 

A job is a unit that consists of one step or a group of steps. It can contain (1) a single program and its 
related data, or several programs and their data, and (2) the monitor and user-level commands that are 
required to control the programs. 

The Batch system allows the user to submit his Job by one of the following three methods: 

I. The user punches his job on cards, inserts control cards to CDRSTK, and leaves his cards 
at the designated place for the operator to run (refer to Paragraph 3.2. 1) 

2 * a'nd the"n ^JSt^" ° P? '? *V *° ^f™ ^^ ° f h ™"* h!s l ob °" -rds) 
ana men tuns LUK5TK himself (refer to Paragraph 3.2.2). 

3. The user bypasses CDRSTK by creqting his own control file on disk for the Batch Controller 
and then enters his job into the Batch input queue from his terminal (refer tVParagraph 
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3.2.1 Submitting a Job with Cards 

With this method, a job is submitted via a deck of cards, bounded by the control cards that mark its 
beginning and end. Other control cards to CDRSTK are interspersed among the card deck to direct 
CDRSTK's processing. Figure 3-1 shows a job containing the appropriate control cards to CDRSTK. 
This job compiles, loads, executes, and lists a FORTRAN program. 



$DATA 




I END OF FILE 



FORTRAN PROGRAM 



$ FORTRAN 



$PASSWORD MUMB 



$J0B TEST2 [20,27]/ 




Figure 3-1 Typical Job on Cards 

3.2. 1 . 1 The $JOB Card - This card notifies CDRSTK that a job is to be processed. CDRSTK creates 

a control file into which commands are placed for the Batch Controller and a log file on the disk. The 
first argument (TEST2) shown on this card is the user-assigned name for the job; the second argument 
([20,27]) is the project-programmer number of the user. For a description of switches which can be 
used on this card, refer to Paragraph 3.3.9. 

3.2. 1 .2 The $ PASSWORD Card - This card contains the PASSWORD associated with the project- 
programmer number specified on the $JOB card. In Figure 3-1, the PASSWORD is MUMB, which was 
assigned to the user by the system manager. Refer to Paragraph 3.3. 12 for more information on the 

$ PASSWORD card. 

3.2.1.3 The $FORTRAN Card - This card causes CDRSTK to insert a COMPILE monitor command 
(refer to Chapter 2) into the control file in order to cause the program to be compiled. Immediately 
following the $FORTRAN card is the FORTRAN source program to be compiled. The source program 
is read into a disk file with the specified filename (or a default name if a filename is not given) and 
with an extension of .F4. Refer to Paragraph 3.3.8 for more information on the $FORTRAN card. 
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3.2.1 .4 The $DATA Card - The card after the FORTRAN program is the $DATA card. This card 
causes CDRSTK to insert an EXECUTE monitor command (refer to Chapter 2) into the control file in 
order to load and then execute the previously compiled program. Refer to Paragraph 3.3.3 for 
additional information on this card. 

3.2. 1 .5 The End of File Card - The last card shown in the example is the end-of-file card. This card 
signals the end of the job. The card is recognized by CDRSTK as the end of the file because of the 
punches in rows 12, 11, 0, 1, 6, 7, 8, 9 in columns 1 and 80 of the card. Refer to Paragraph 3.3 for 
more information about this card. 

3.2.1.6 Output - Once the program is punched on cards, the card deck is submitted to the operator, 
who in turn stacks the job in the card reader. The user receives his output in the form of line printer 
listings. Refer to Paragraph 3.5 for an explanation of the job output. 

The CDRSTK control cards shown in Figure 3-1 are just a few of the control cards available to the 
user. For a complete description of all the CDRSTK control cards, refer to Paragraph 3.3. 

3.2.2 Submitting a Job with a File 

With this method, a Job is submitted via a file contained on any input device that supports ASCII 
code. This file contains the program and data with card images of the control cards for CDRSTK. The 
following example shows the creation of a disk file containing a FORTRAN program and card images 
of CDRSTK control commands. Note that it corresponds to the card example in Paragraph 3.2. 1 . 

JOB 17 5S0 4 TTY1 1 
PASSWORD: 



1020 15-M A K-72 WED 
jjY-AKF J0Fl~J 

*I SJOB TEST2, l r <>V\,21lJ 
SFORTRANj) 

C FORTRAN PROGRAM GOES HERE 
SFOD^ 
SDATAj 
££ 
*EX$S 



3.2.2. 1 Image of the $JOB Card - The first line of the file is an image of the $JOB card,, Note that 
the $ character must be the first character of the line in.order for CDRSTK to recognize it as a control 
command. This line causes a control file and a log file to be created on the disk when CDRSTK is run. 
The first argument (TEST2) is the user-assigned name for the job; the second ([20,27]) is the 
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project-programmer number of the user. The $PASSWORD card image is not needed because the user 
is already logged-in when creating the input file. For additional information on the $JOB card, refer 
to Paragraph 3.3.9. 

3.2.2.2 Image of the $FORTRAN Card - This line causes CDRSTK to insert a COMPILE monitor com- 
mand (refer to Chapter 2) into the control file in order to compile the program. The source program 
follows immediately and is read into a disk file with the specified filename (or a default name if a file- 
name is not given) and with an extension of .F4. Refer to Paragraph 3.3.8 for more information on 
the $FORTRAN card. 

3.2.2.3 Image of the $EOD Card - This line indicates to CDRSTK the end of the FORTRAN program. 
Refer to Paragraph 3.3.6 for more information. 

3.2.2.4 Image of the $DATA Card - This line causes CDRSTK to insert an EXECUTE monitor com- 
mand (refer to Chapter 2) into the control file in order to load and execute the program. 

3.2.2.5 Running CDRSTK - Once the file is created and CDRSTK is run by the user, it processes the 
user-created file in the same manner as it processes input files of jobs entered directly by the operator. 
The user runs CDRSTK by typing 

^R CDRSTK J 

CDRSTK responds with an asterisk, and then the user types in the following command 

*STARTdev:file.ext^ 
where dev: is the name of the device containing the input file for CDRSTK and file.ext is the name of 
the file. Us'ing the above file, the command is 

+START DSK: JOB ^ 
and CDRSTK responds with 
I 

When CDRSTK has completed its processing (i.e., when it has created the control and log files and has 
entered the job into the Batch input queue), it responds with 

READY 
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indicating its readiness to accept another file. At this point, the user can enter another File or return 
to monitor mode with a tC. 

The card images shown in the preceding example are only a few of the CDRSTK control card images 
available. Refer to Paragraph 3.3 for a complete description of all of the control cards. 

3.2.3 Submitting a Job with a Control File to the Batch Controller 

With this method, a job is submitted via the steps within a control file to the Batch Controller. The 
file must be a disk file and is created with a system editor. Since this file is processed directly by 
the Batch Controller, control card images are not used. The control file consists of monitor commands, 
user program commands, comments, and sequence control statements. Refer to Paragraph 3.4 for a 
description of control file commands. The following is an example of creating a control file. It 
assumes that a file named DATA.F4 already exists on disk. 

• MAKE J06.CTL \ 

*I .FXEXUTF /COMPILE DATA.F4 /LISTj 

FXSS 

Once the control file is created, the user can enter the job into the Batch input queue one of three 
ways:- 

1. SUBMIT fobnarne = control file, log file 
refer to the SUBMIT command in Chapter 2. 

2. QUEUE IN P: jobname = control file, log file 
refer to the QUEUE command in Chapter 2. 

3. R QUEUE 

refer to the QUEUE specification in Notebook 7 of the DECsystem-10 Software Notebooks. 

3.2.4 Inter job Dependency 

Jobs are not necessarily run in the order that they are read into the Batch System. Priorities stipulated 
by the user on the $JOB card (refer to Paragraph 3.3.9) and additional parameters set by the Batch 
System are dynamically computed by the Queue Manager to determine in what order the jobs are run. 
However, it is often useful to submit several jobs that must be run in a specific order, for example, one 
job updates a master file and another job processes it. Therefore, the running of one job is dependent 
upon the running of the other. Although these jobs could be combined into one large job, it is some- 
times necessary to keep them distinct; i.e. , they might be submitted by different people at different 
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times. Because the jobs in the Batch System are run in order of priority, the user specifies an addition- 
al priority, an initial dependency count, on the $JOB card of the dependent job. This dependency 
count becomes part of the queue entry. Any input queue entry that has a dependency count greater 
than zero cannot be scheduled. When the count becomes zero, the job is scheduled, based upon the 
time it was submitted and the time that the dependency count became zero. If the dependency count 
becomes negative, an advisory message is sent to the issuing job and to the dependent job. The 
dependency count can be altered by including the QUEUE command as part of any job upon which the 
dependent job is waiting. (Refer to the QUEUE monitor command. ) The QUEUE command switch that 
allows the user to change the dependency count of another job is the /MODIFY/DEPEND :nn switch. 
If the user specifies a plus or minus sign before the count (nn), that number is subtracted from or added 
to the dependent job's count. If the user does not specify a sign, the dependent job's count is changed 
to the count specified in the /MODIFY/DEPEND: switch. 

3.3 CDRSTK CONTROL CARDS 

Control cards are interspersed among the input stream to aid CDRSTK in separating the input into the 
appropriate files, either the user's data files or the control file processed by the Batch Controller. The 
control cards contain a dollar sign ($) in column 1 and an alphabetic character in column 2. These are 
the only cards read and interpreted by CDRSTK; the remainder of the input is separated and placed into 
the appropriate file. Note that if the user creates his own control file, he bypasses CDRSTK, and, 
therefore, does not use these control cards. 

Only the first part of the command name or switch need be specified; as long as the name is unique, 
it is accepted. The first three characters of a command name are generally sufficient to ensure 
uniqueness. The standard comment and continuation conventions for the system can be used on the 
control card. A comment is preceded by a semicolon; characters after the semicolon to the end of 
the card are treated as comments. A card may be continued by placing a hyphen as the last non-TAB 
or non-space character before the end of the card. Comments beginning with a semicolon, TABs, and 
spaces can follow. All defaults for control card parameters are installation parameters. 

The end-of-file is used to signal the end of the job. When input is from the card reader, an end-of- 
file card is used. Column 1 of this card has rows 4 and 5 blank and rows 6, 7, 8, and 9 punched. 
The recommended form of this card has columns 1 and 80 containing punches in rows 12, 11, 0, 1, 6, 
7/ 8, 9, with rows 2, 3, 4, and 5 blank, so that the card can be recognized in any orientation. 
When devices other than the card reader are used for input, the standard end-of-file for each device 
is treated by CDRSTK as the end of the job. 
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$ALGOL 



Function 

This card causes CDRSTK to copy the named ALGOL program onto disk and to insert a 
COMPILE monitor command into the control file. The card is placed at the beginning of the 
source program. When the job is run, the specified program is compiled and temporary relo- 
catable binary and listing files are created. The binary and listing files can be made perman- 
ent if the user renames them to change their protection. The source file can be preserved by 
means of the /PROTECT switch. The listing file is printed as part of the job's output. 

Processor switches can be passed to the ALGOL compiler by including them in the command 
string. The position of these switches in the command determines their position in the 
COMPILE command generated by CDRSTK. For example 

$ALGOL/NOLIST (E,,N) 

results in the following COMPILE command 

.COMPILE /COMPILE DEC KAA.ALG/NOLIST (E,,N) 

Refer to Paragraph 1 „5. 7 for a description of the ALGOL processor switches. 

Card Format 

I $ALGOL dev :name . exlr [proj, prog] (processor switches) /S ./S . . ./S 

dev: = a file structure name. If omitted, DSK is assumed. 

name.ext = the name of the file to be created on disk. If omitted, CDRSTK assigns a 
unique filename of the form DECKaa (where aa = AA through ZZ) with the extension 
.ALG. It is recommended, however, that the user select a distinct filename for each 
job that is in the Batch system simultaneously. 

[proj,prog] = a directory name other than that specified on the $JOB card. If omitted, 
the project-programmer number _on the $JOB card is used. 

I (processor switches) = the switches to be passed to the ALGOL compi ler. They must be 

enclosed in parentheses and the slash cannot appear in connection with these switches. 

/S./S^. . ./S == the switches that control the mode of input interpretation and the 
listing of the compiled program. 

Switch Meaning Default 

/ASCII The input is read in ASCII mode. on 

/D029 The card deck is read in the old DEC-029 format. off 

This format is similar to ASCII and is available 
only in those installations that use DEC-029 format. 

/LIST A temporary listing file of the program is created. on 



(continued on next page) 
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Card Format (cont) 

Switch 
/NOLIST 
/PROTECT :nnn 



/SUPPRESS: 
ON or OFF 

/WIDTH :nn 



/026 



Meaning 
No listing file of the program is created. 
The protection to be set for the file (in octal). 



When ON is specified, trailing blanks are suppressed, 
They are not suppressed when OFF is specified. 

The maximum number of columns to be read. If the 
specified width is less than 80, only that number of 
columns is read. The remaining columns are treated 
as blank. Normally this switch is only used when 
the /SUPPRESS switch is on. 

The card deck is read in 026 card code. 



Default 

off 

The file is preserved 
only until KJOB 
for the job. 



80 



off 



Restrictions 



The /026 and /D029 switches apply only to card reader input. Input from other devices must 
be read in ASCII code; otherwise an error message is written in the log file and the job is 
terminated. 

3.3.2 



$COBOL 



Function 



This card causes CDRSTK to copy the specified COBOL program onto disk. The card is placed 
at the beginning of the source program, and when CDRSTK reads the card, it inserts a 
COMPILE monitor command into the control file and copies the COBOL program into the file 
on the specified disk area. When the job is run, the program is compiled and a temporary re- 
locatable binary file and a temporary listing file are created. The binary and listing files can 
be made permanent if the user renames them to change their protection. The source file can 
be preserved if the user specifies the /PROTECT switch. The listing file is printed as part of 
the job's output. 

Processor switches can be passed to the COBOL compiler by including them in the command 
string. The position of these switches in the command determines their position in the 
COMPILE command generated by CDRSTK. 

For example 

$COBOL (A,M,C) /PROTECT :057 

results in the following COMPILE command 

.COMPILE /COMPILE DECKAB.CBL (A,M,C) /LIST 

Refer to Paragraph 1 .5.7 for a description of the COBOL processor switches. 
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Card Format 



$COBOLdev:name.ext [proj,prog] (processor switches) /S./S-. . ./S 

12 n 

dev: = a file structure name. If omitted, DSK is assumed. 

name.ext = the name of the file to be created on disk. If omitted, CDRSTK assigns a 
unique filename of the form DECKaa (where aa = AA through ZZ) with the extension 
.CBL. It i«, recommended, however, that the user select a distinct name for each job 
in the Batch system simultaneously. 

[proj,prog] = a directory name other than that specified on the $JOB card. If omitted, 
the project-programmer number on the $JOB card is used. 

(processor switches) = the switches to be passed to the COBOL compi ler. They must be 
enclosed in parentheses and the slash cannot appear in connection with these switches. 

/S^S .../$ n = the switches that control the mode of input interpretation and the list— 
i ng orthe compi led program . 



Switch 
/ASCII 
/D029 

/LIST 
/PROTECT :nnn 

/SEQUENCE 



/SUPPRESS: 
ON or OFF 

/WIDTH :nn 



/026 



Meaning 
The input is read in ASCII mode. 

The card deck is read in the old DEC-029 format. 
This format is similar to ASCII format and is available 
only in those installations that use DEC-029 format. 

A temporary listing file of the program is created. 

Specifies the protection to be set for the job (in octal). 



The program is read in conventional COBOL format 
with sequence numbers in columns 1 through 6, and 
comments beginning in column 73. When this switch 
is specified, the default width is 72. 

When ON is specified, trailing blanks are suppressed. 
They are not suppressed when OFF is specified. 

The maximum number of columns to be read. If the 
specified width is less than 80, only that number of 
columns is read, the remaining columns are treated 
as blank. Normally this switch is used only when 
the /SUPPRESS switch is on. 

The card deck is read in 026 card code. 



Default 
on 
off 



on 



lhe file is preserved 
only until KJOB 
for the job. 



on 



on 



80 



off 



Restrictions 



The /026 and /D029 switches apply only to card reader input. Input from other devices must 
be read in ASCII code; otherwise, an error message is written in the log file and the job is 
terminated. 
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3.3.3 
$DATA I 



Function 



This card causes CDRSTK to copy data into a file on the user's disk area and to insert an 
EXECUTE monitor command into the control file. 

CDRSTK maintains a list of filenames of all source or relocatable programs that have been pro- 
cessed since the beginning of the job or the last $DATA card read. Each time a program is 
copied by the CDRSTK, its name is placed in the list and given an extension of .REL. When 
the $DATA card is read, CDRSTK places an EXECUTE command into the control file and copies 
the filenames of the programs into the EXECUTE command string. On the next Slanguage card, 
CDRSTK clears the list of filenames so that the next entries into the list reflect only those file- 
names copied since the last $DATA command was read. When the job is run, the programs are 
loaded and executed. No compilation is performed because the programs are either in relo- 
catable binary form or have been previously compiled because of the Slanguage card. If two 
$DATA cards appear in a row, the same programs are reloaded and executed again. 

Loader switches can be passed to the LOADER by placing them in the command string. When 
CDRSTK places these switches in the EXECUTE command,' it converts them to the standard 
LOADER switch format (i.e., % switch). For instance, 

$DATA(S,F) 

causes the following EXECUTE command to be generated 

.EXECUTE ... %S %F 



Card Format 



$DATA devrname.ext [proj,prog] /S^/S_. . ./S 

dev: = a file structure name. If omitted, DSK is assumed. 

name.ext = the filename of the file to be created. If omitted, CDRSTK creates a 
unique filename of the form Qaa (aa = AA through ZZ) with the extension .CDR. 

It is recommended, however, that the user select a distinct name for each job that 
is in the -Batch system simultaneously, so that he can distinguish the various output 
listings. 

[pro], prog] = the directory name if different from the one specified on the $JOB card. 
If omitted, the project-programmer number specified on the $JOB card is used. 

/S /S /S = switches that control the mode of reading and interpreting of the input 

' \\. 2" n 

media. 
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Card Format (cont) 



Switch 
/ASCII 
/BINARY 



/D029 
/IMAGE :n 



/PROTECT :nnn 



/SUPPRESS- 
ON or OFF 

/WIDTH :nn 



/026 



Meaning 

The input stream is read in ASCII mode. 

The card deck is read in binary card form. This switch 
is ordinarily not necessary because the first column of 
each card is checked for punches in rows 7 and 9. If 
these rows are punched, the card is read in binary. 

The card deck is read in the old DEC-029 format. This 
format is similar to ASCII format and is available only 
for compatability with old decks. 

The card deck is read in image mode. The switch must 
be followed by a decimal number in the range 2 
through 80. This causes ensuing cards to be read in 
image mode until either end-of-file is reached or a 
card is read that contains punches in all rows of col- 
umn 1 and all rows in column n. The CDRSTK control 
commands are not recognized when cards are read in 
image mode. 

A protection of nnn (octal) is set for the file; if not 
specified, the file is preserved only until a KJOB 
command for the job. 

When ON is specified, trailing spaces are suppressed. 
They are not suppressed when OFF is specified. 

The maximum number of columns to be read. If the 
specified width is less than 80, only that number of 
columns is read. The remaining columns are treated 
as blanks. Norma !ly, this switch is only used when 
the /SUPPRESS switch is on. For example, /WIDTH :72 
causes the CDRSTK to disregard columns 73 through 80 
and to suppress any trailing spaces up to column 72. 

The card deck is read in 026 card code. 



Default 
on 
off 



off 



off 



80 



off 



The modes ASCII, 026, IMAGE, and D029 are mutually exclusive modes for interpreting 
Hollerith punches. When one of those modes is set, it remains in effect until changed (refer 
to the $MODE card) or the end of file is reached. 

The defaults for all modes are reset by the next $MODE card or by individual swftches in other 
control cards such as in the $DECK card. 



Requirements 



If the data is contained within the programs instead of being a separate file, a $DATA card or 
an EXECUTE command must be placed after the programs. The program wi II not be executed 
otherwise. 
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Restrictions 

This card can be used only when the programs in the job have been entered with a Slanguage 
card or $RELOCATABLE card, since CDRSTK maintains a list of the filenames of programs that 
are input with these commands. If the user wishes only to have the programs compiled, no 
$DATA card or EXECUTE command should appear in the job. 



3.3.4 



$DECK 



Function 

This card causes CDRSTK to copy all statements up to the next control card into a data file. 

Card Format 

$DECK devrname.ext [proj,prog] /SVS^. . ./S 

dev:= a file structure name. The default is normally DSK. 

name.ext = the user-assigned name and extension of the file to be created. If omitted, 
a unique filename in the form DECKaa (aa = AA through ZZ) is created by CDRSTK 
with the extension .CDR. It is recommended, however, that the user select a distinct 
name for each job that is in the Batch system simultaneously. 

[proj,prog] = a disk area other than the one supplied on the $JOB card. If omitted, 
the project-programmer number specified on the $JOB card is used. 

/S./S„. . ,/S = switches that control the mode of reading and interpreting of the input 
media. The switches are identical to the switches described for the $DATA card. 

Restrictions 

The /BINARY, /026, /IMAGE, and /D029 switches apply only to card reader input. Input 
from other devices must be read in ASCII code; otherwise an error message is written in the 
log file and the job is terminated. 



3.3.5 



$DUMP 



Function 



This card causes CDRSTK to insert a DUMP monitor command into the control file which invokes 
a dump, according to the arguments specified, when an error is detected by the Batch Control- 
ler. 
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Ccird Format 

$DUMP /command arg/command arg, . . 

The commands and their arguments are the same as described for the DUMP program. (Refer to 
Chapter 2). Two of the commands useful to a Batch job are duplicated below. 

Meaning 
Dumps the entire file. 
Dumps the specified bytes in the current modes. 



3.3.6 



Command 
Al 1 


Argument 


DUMP 


curnp descriptor, 




curnp descriptor,, . . . 



$EOD 



Function 



This card terminates the input that is being copied into a data file by CDRSTK because of 
a preceding $DECK card. All control cards with the exception of $MODE perform this action, 
i.e., terminate the copying of input. If input is not being copied and this card is read, 
CDRSTK ignores it. $EOD is only necessary when the user wishes to place a line of input 
which is not a CDRSTK control card after input that is being copied into a data file. 



Card Format 



$EOD 



3.3.7 



$ERROR 
$NOERROR 



Function 



These cards are used to aid the Batch Controller in processing errors. They cause CDRSTK to 
insert an .IF statement into the control file; e.g., .IF (ERROR) or .IF (NOERROR). Refer to 
Paragraph 3.4.5 for an explanation of the .IF statement. These cards must appear at the point 
at which the error occurs. 
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Card Formats 

$ ERROR statement 

$ NO ERROR statement 

statement = an executable monitor or batch command preceded by a period. If 
the statement directs the Batch Controller to go to a statement label , the statement 
label line and any related lines must be included in the sequence of commands 
at the place the user wants it executed. For example, 

$FORTRAN TEST! 



$ERROR .GOTO A 
$ DATA TEST! DA 



$ERROR .GOTO A 

A: CONT 

$ FORTRAN TEST2 



3.3.8 



$FORTRAN or $F40 



Function 



This card causes CDRSTK to copy the named FORTRAN program onto disk and to insert a 
COMPILE monitor command into the control file. The card is placed at the beginning of the 
source program. When the job is run, the specified program is compiled and temporary relo- 
catable binary and listing files are created. The binary and listing files can be made perman- 
ent if the user renames them to change their protection. The source file can be preserved by 
means of the /PROTECT switch. The listing file is printed as part of the job's output. 

Processor switches can be passed- to the FORTRAN compiler by including them in the command 
string. Their position in the command string determines their position in the COMPILE com- 
mand generated by CDRSTK. For example, 

$FORTRAN (A,S,D)/NOLIST 
results in the following COMPILE command 

.COMPILE /COMPILE DECKII.F4 (A,S,D)/NOLIST 

Refer to Paragraph 1 .5.7 for a description of the FORTRAN processor switches. 



Version 11 CDRSTK 3-17 



COMMANDS 



- 726 - 



Card Format 



$FORTRAN devrname.ext [proj,prog] (processor switches) /S/S /S 

$F40 dev:name.ext [prof, prog] (processor switches) /S../S-. . ,/S 

1 2 n 

dev: = a file structure name. If omitted, DSK is assumed. 

name.ext = rhe name of the file to be created on disk. If omitted, CDRSTK assigns a 
unique filename of the form DECKaa (where aa = AA through ZZ) with the extension 
L D ' S i recommended ^ however, that the user select a distinct name for each job 
in the Batch system simultaneously. 

[prof, prog; = a directory name other than that specified on the $JOB card If omitted 
the pro|ect-programmer number on the $JOB card is used. 

(processor switches) = the switches to be passed to the FORTRAN compiler. They must 
be enclosed in parentheses and the slash cannot appear in connection with these 
switches. 



Switch 
/ASCII 
/CREF 

/DQ29 

/LIST 

/M 

/NOLIST 

/PROTECTrnnn 



/SUPPRESS: 
ON or OFF 

/WIDTH :nn 



/ s j/ V • ./S n - the switches that control the mode of input interpretat 
ing oFrhe compiled program. 



/026 



Meaning 
The input is read in ASCII mode. 

A cross-referenced listing file is created to be pro- 
cessed by the CREF program. 

The card deck is read in the old DEC-029 format. This 
format is similar to ASCII" and is available only in those 
installations that use DEC-029 format. 

A temporary listing file of the program is created. 

The MACRO coding is included in the output listing. 

No listing file of the program is created. 

The protection to be set for the file (in octal). 



When ON is specified, trailing blanks are suppressed. 
They are not suppressed when OFF is specified. 

The maximum number of columns to be read. If the 
specified width is less than 80, only that number of 
columns is read. The remaining columns are treated 
as blank. Normally this switch Is only used when 
the /SUPPRESS switch is on. 

The card deck is read in 026 card code. 



ion and the list- 
Default 
on 
off 

off 



on 
off 
off 



The fi le is preserved 
only until KJOB for 
the job. 



72 



off 



Restrictions 



^l^tn a ^a?^^ ?t 5! ,, " - PP ' y ° n,y f ° card reader Fnput ' Input from ohher devices mus ' 

terminated otherw.se, an error message is written in the log file and the job is 
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3.3.9 



$JOB 



Function 

This card, in conjunction with the $PASSWORD card (if required), causes CDRSTK to create a 
control file and a log file on disk into which commands are placed for the Batch Controller. 
The filename of the control file is the name of the job specified in the command string, and 
the extension is .CTL. CDRSTK also uses this name as the filename of the log file with an 
extension of . LOG. If the jobname is omitted from the command string, CDRSTK creates a 
unique name for the control file and log file. It is recommended, however, that the user select 
a distinct name for each job that is in the Batch system simultaneously, so that he can distin- 
guish the various output listings. In general, the jobname used on input appears in the output 
queues. CDRSTK adds the control and log files to the directory of the specified project- 
programmer number. 

The user may specify a wildcard designation ( # ) for the programmer number in the $JOB card, 
for example, 

$JOB FLEX[4, # ] or $JOB FLEX [4] 

This specification causes CDRSTK to look at ACCT.SYS (an administrative file) in order to 
determine if the wildcard option is allowed for this project. If it is, CDRSTK provides a unique 
programmer number within the project. If it is not allowed, CDRSTK returns an error message 
and continues with the next job. , 

Card Format 

$JOB name [proj,prog] /S^/S^.. ,/S^ 

name = the user-assigned name for the job; if omitted, CDRSTK creates a unique name 
of the form JOBaaa (aaa = AAA through ZZZ) for the control and log files. 

[proj,prog] = the project-programmer number of the user who submitted the job. This 
argument is required. A space or comma can separate this argument from the jobname. 

/S,/S„.. ./S = switches taken from the following group. These switches are optional. 
' V 2 n 

Switch Meaning Default 

/AFTER:dd-mmm-yy hhmm The job cannot be run until after the speci- None 

fied date and time. The resulting AFTER 
time must be less than the DEADLINE time. 

/AFTER:+tt Tne i ob cannot be run until after the input None 

time plus the number of minutes indicated 
by tt. 

/CARDSrnnk The maximum number of cards (up to 1 OK) 

that can be punched by the job (in decimal). 
K is optional . 

(continued on next page) 
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C ard Format (cont) 

Switch 
/CHARGEiaa 

/CORE:nnk 
/DEADLINE:dd-mmm-yy hhmm 

/DEADLINE :+tt 

/DEPENDmn 
/FEETrnn 

/LOCATErSnn 

/NAMEraa 
/PAGES:nn 

/PRIORITY:nn 
/PROTECT:nnn 

/RESTART:0 or 1 

/TIME:hh:mrn:ss 
/TPLOTrmm 
/UNIQUErO or 1 



Meanin g 

The fob is charged to a user-specified account 
(aa ~ name of the account) . 

Maximum amount of core (in decimal) that can 
be used by the fob up to the maximum allowed 
by the installation. K is optional. 

The job must be completed by the specified 
date and time. The resulting DEADLINE 
time must be greater than the AFTER time. 

The job must be started by the indicated 
number of minutes after it is input. 

Initial interjob dependency count (in decimal). 

The number of feet of paper tape that will be 
punched by the job. 

Specifies the remote station of the fob and 
where the output is to be sent. 



The user's name in up to 12 characters. 

The maximum number of pages in decimal to 
be printed by the fob, including the log file 
and compilation listing. 

The external priority of the fob; the highest 
priority that can be specified is 62 (decimal). 

The protection (in octal) for the job, the control 
file, and the log file. 

If 0, the job cannot be restarted by the operator. 
The job can be restarted if 1 is specified. The 
fob should not be restartable if there are changes 
to the permanent file directory. 

The limit placed on the amount of CPU time 
used by the job. 

The number of minutes of plotter time that the 
job will use. 

If 1 , only one Batch job at a time is run using 
the specified directory. If 0, any number of 
Batch jobs can be run at the same time using the 
specified directory. 



Defau It 
None 

25K 
None 

None 




The station where 
the cards were 
input. 

None 
100 



Preserved only 
until KJOB is 
given for the job. 





5.0 (5 minutes) 

1 



Requirements 



The $JOB card must immediately follow the $SEQUENCE card, or be the first card if the 
$SEQUENCE card is not required. 
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3.3.10 



$MACRO 



D 



Function 



This card causes the CDRSTK to copy the designated MACRO program onto disk and is > placed 
at the beginning of the source program. When CDRSTK reads the card it mserts a COMPILE 
Ini tor command into the control file and copies the MACRO program .^theM. -an he 
specified disk area. When the job is run, the program „ assembled and a ^P™* ™°°* 
able binary file and listing files are created. The binary and hstmg f.le. can be made per- 
manent if the user renames them to change their protection. The source f.le .s preserved by 
means of the /PROTECT switch. The listing file is printed as part of the |ob s output. 

Processor switches can be passed to the MACRO assembler by including them in .the .command 
string. Their position in the command string determines their pos.t.on in the COMPILE com- 
mand generated by CDRSTK. For example 
$MACRO /PROTECT :055 (W,S,Q) 

results in 

.COMPILE /COMPILE DECKCB. MAC /PROTECT :055 (W,S,Q)/L1ST 

Card Format 

$MACRO devrname.ext [proj,prog] (processor switches) /S^. . ./S n 
dev: = a file structure name. If omitted, DSK is assumed. 

name ext = the name of the file to be created on disk. If omitted CDRSTK assigns a 
~Klename in the form DECKaa (ad = AA through ZZ) with the extens.on .MAC. 
However, it is recommended that the user select a distinct name for each ,ob m the 
Batch system simultaneously. 

[proj /P rog] = a directory name other than that specified on the $JOB card. If omitted, 
the project-programmer number on the $JOB card is used. 

(processor switches) = the switches to be passed to the MACRO assembler They must 
I be enclosed in parentheses and the slash cannot appear in connect.on w.th these 

switches. 

/S /S . . ./S = the switches that control the mode of input interpretation and the list- 
ing of the assembled program. 

Switch i^S ^ 

/ASCII Tne ' n P ut ' s read ' n ASCI1 mode. 

/ CREF A cross-referenced listing file is created to be pro- off 

cessed by the CREF program . 

(continued on next page) 
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C ard Format (cont) 

Switch 
/D029 

/LIST 
/NOLI ST 
/PROTECT :nnn 



/SUPPRESS: 
ON or OFF 

/WIDTH :nn 



/026 



Restrictions 



Meaning 

The card deck is read in the old DEC-029 format. 
This format is similar to ASCII and available only in 
those installations that use DEC-029 format. 

A temporary listing file of the program is created. 

No listing file of the program is created. 

The protection to be set for the file (in octal). 



When ON is specified, trailing blanks are suppressed. 
When OFF is specified, they are not suppressed. 

The maximum number of columns to be typed. If the 
specified width is less than 80, only that number of 
columns is read. The remaining columns are treated 
as blank. Normally, this switch is used only when 
the /SUPPRESS switch is on. 

The card deck is read in 026 card code. 



Default 
off 



on 
off 



The file is preserved 
only until KJOB for 
the fob. 



80 



off 



The /026 and /D029 switches apply only to card reader input. Input from other devices must 
be read m AbUl code; otherwise, an error message is written in the log file and the iob is 
terminated. ' 



3.3.11 



r $MODE 



Function 



SMODE T K , ChQ T tHe m ° de ?n Whlch If is -^ting the input stream. The 

$MODE card can be placed anywhere after the $PASSWORD card in the command sequence 
and ,s terminated by another $MODE card or the end-of-file (which terminates the job). This 
command does not terminate the copying of input preceded by a $DECK card 



Card Format 



SMODE/Sj/S.,. 



..A 
•A 



... ~ T , ,, swi ( fches tho * control the mode of reading and interpreting of the input 
med.a. These sw.tches are identical to the switches described for the $DATA card. 
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Restrictions 



The mode switches /026, /IMAGE, /D029, and /BINARY can be used only for card input. 
Input from other devices is always read as ASCII code. Thus, the only switches that can be 
used with the $MODE card for devices other than the card reader are /SUPPRESS and /WIDTH. 



3.3.12 



$ PASSWORD 



Function 



This card contains the password associated with the project-programmer number specified in 
the $JOB card. If the password does not match the password stored in the system for the speci- 
fied project-programmer number, CDRSTK does not create any files and aborts the job. Use of 
this command is an installation option. 



Card Format 



$ PASSWORD password 

password = 1 to 6 character password. 



Requi rements 



If the $PASSWORD card is required, it must immediately follow the $JOB card. 



3.3.13 



$RELOCATABLE 



Function 

This card causes CDRSTK to copy a relocatable binary program from cards to a file on the user's 
disk area. The cards are read in binary mode. . 

Card Format 

$RELOCATABLE dev:name.ext [proj,prog] /S. 

dev:= a file structure name. If omitted, DSK is assumed. 

name.ext = the name of the file into which the program is copied. If the filename is 
omitted, CDRSTK creates a unique name in the form DECKaa (aa = AA through ZZ). It 
is recommended that the user select a distinct name for each job in the Batch system 
simultaneously. If the extension is omitted, .REL is assumed. 

(continued on next page) 
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Card Format (cont) 

[proj,prog] = the disk directory if different from the one specified on the $JOB card. 
If omitted, the project-programmer number on the $JOB card is assumed. 

/S =/PROTECT:nnn (octal) 

The protection for the file to be created. If not specified, the file is preserved 
only until a KJOB command for the job is executed. 

Restrictions 

Relocatable binary programs can only be read when the input is from cards. 

The program following this command must be read in binary; the mode cannot be changed until 
a nonbinary file is copied. If an attempt is made to change the mode, an error message will be 
issued and the job will be aborted. 



3.3.14 



$SEQUENCE 



Function 



This card specifies the job's unique sequence number. The use of this card depends on the re- 
quirements of the particular installation. 



Card Format 



$SEQUENCE n 

n = a decimal number 

Requirements 

If the installation requires this command, it must be the first card in the input stream. 

3.4 BATCON CONTROL FILE COMMANDS 

Ordinarily the Batch Controller reads the control file in a sequential manner. The commands described 
in this section can appear in the control file to interrupt the sequential processing of the control file in 
order to specify error recovery. If an error occurs in the job, the Batch Controller is notified of the 
error; the user has the option of including several methods of error recovery. 

The user may include an .IF command in the control file. When the error occurs, the Batch Controller 
examines the next monitor level line in the control file for an .IF command to determine what action 
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to take on the error. It does not search past the next executable monitor line in the control file for 
the .IF command; therefore, if this command is used, it must be the next monitor command in the con- 
trol file. 

If the user does not wish to include an .IF command, he may include two types of error recovery rou- 
tines in the control file, one type labeled %ERR (error processing for non-system programs) and the 
other labeled %CERR (error processing for compilers and system programs). A system program is one 
found on a device specified in the SYS search list in [1,4] . If SYS is assigned as a logical device 
name, the programs are considered user programs, not system programs. After an error occurs in the 
job and the next executable monitor line in the control file is not an .IF statement, the Batch Control- 
ler searches for the labeled error recovery control lines and processes the statements following these 
labels. These routines may be placed anywhere in the control file. Once the Batch Controller has 
processed the routine, it continues from that point in the control file; it does not read backwards over 
sections of the control file skipped in searching for the error routines. The following example shows 
the use of a %ERR error recovery routine. 

.COMPILE SAMPLE /LIST^ 

.MOUNT MTA:3 /VID:42936^ 

.EXECUTE^ 

.DISMOUNT 3 J 

.R SORT^ 

*MUMP.SRT-FOR04.DAT/RS0/K1 . 1 J 

.QUEUE MUMP.SRTj 

%ERR: .CLOSER 

.DUMP^ 

.DISMOUNT 3 J 

%F IN:. DELETE FOR04.DAT^ 

Depending on the type of error found, 1 the following operations are performed. If a compilation error 
occurs, only the compilation and the listing result. No tape is mounted. If an execution error results, 

1. the program is compiled, 

2. the tape is mounted, 

3. the program begins execution, 

4. the output is closed, . 

5. a quick dump of core is taken, 

6. the tape is dismounted, and 

7. the fi le FOR04. DAT is deleted. 

If a SORT error occurs, the program compiles, the tape is mounted, the program is executed, and the 
file FOR04.DAT is deleted. Finally, if no errors result, 

1 . the program is compi led, 

2. the tape is mounted, 

3. the program is executed, 

4. the tape is dismounted, 

5. the sort is performed, 

6. MUMP. SRT is printed, and 

7. the file FOR04.DAT is deleted. 
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When the user is bypassing CDRSTK and creating his own control file, he may place a %FIN at the end 
of the control file. (CDRSTK, in creating the control file, automatically places a %FIN at the end.) 
This label is used for cleanup purposes, e.g., deleting the input files. In creating the control file, 
the user may place other %FIN's at various points in the file for periodic cleanup of his job. For 
example, this label is used in a special kind of error recovery. If the time allocated to the job runs 
to the maximum limit specified in the $JOB command (refer to Paragraph 3.3.9) or by the Batch sys- 
tem, the user is given an additional 10% of his allocated time to cleanup his job before it is aborted. 
Because the user includes a %FIN, cleanup is performed and the results of the job's processing are not 
•lost when the job is aborted. The user should be careful in using the %FIN in the control file because 
if the Batch Controller is searching for an error recovery routine and %FIN is placed before a %ERR or 
%CERR, the %FIN is executed and the Batch Controller assumes the error recovery routine has been 
satisfied and does not search any longer for %ERR or %CERR. Furthermore, a .GOTO label cannot 
bypass a %FIN label. Therefore, the best place to put a %FIN is as the last line in the control file. 

If an error occurs in the job and the user either was not running a system program or has not included 
an .IF command or error recovery control lines, the Batch Controller initiates a standard quick dump 
of the user's core area and terminates the job (refer to the DUMP command in Chapter 2). The Batch 
Controller also initiates a dump if it is searching for a %ERR and reads a %FIN instead. 



3.4.1 



BACKTO 



Function 



The .BACKTO command is used by Batch users to interrupt the sequential reading of the control 
File by the Batch Controller. Control is transferred in a backward direction. This command 
can be used with a .IF command to specify transfer of control to an error routine. 



Command Format 



. BACKTO label 

label = label of a statement in the control file. This label is from one to six alpha- 
numeric characters terminated with a colon and must not begin with a % character. 

When the .BACKTO command is encountered, the Batch Controller searches for the labeled 
statement and transfers control to it. If the statement is not found, the job is terminated. 
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3.4.2 



CHKPNT 



Function 



The CHKPNT command is used to aid in error recovery when a Batch job is terminated abnor- 
mally, by a system failure. As many .CHKPNT commands as desired can be placed in the 
control file. When the job is restarted after the failure, the program beg.ns at the location 
of the last .CHKPNT command instead of at the beginning of the program. 



Command Format 

.CHKPNT label 



label = label of a statement in the control file. . This label is from one to five alpha- 
numeric characters. When the label appears with the statement in the control file, it 
must be followed by a double colon instead of the usual single colon (e.g., 
label :: statement). 



3.4.3 



ERROR 



Function 



The .ERROR command causes the Batch Controller to recognize a message beginning with the 
specified character. as an error in the job. 



Command Format 



. ERROR character 



character = the beginning character of the line that is to be recognized as an error 
(e.g., %)• If this argument is not specified, a ? at the beginning of a line is con- 
sidered as an error. 



3.4.4 



GOTO 



Function 



The .GOTO command is used by Batch users to interrupt the sequential reading of the control 
file by the Batch Controller. Control is transferred in a forward direction. This command may 
be used with a .IF command to specify transfer of control to an error routine. 
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Command Format 

. GOTO label 

label = label of a statement in the control file. The label appearing in the control file 
is from one to six alpahnumeric characters terminated with a colon and must not begin 
with a % character. y 

When the . GOTO command is encountered, the Batch Controller searches for the labeled 
statement and transfers control to it. If the statement is not found before the end of the con- 
trol tile is reached, rhe |ob is terminated. 



Examples 



• F'X TEST. MAC /L 

• IF (ERROR) .GOTO A 
•GOTO B ' 

A::. QUEUE LPT : =TEST .MAC 

• GOTO B 
B: :; 



3.4.5 



.IF 



Function 



The IF command „ used by Batch users to aid the Batch Controller in processing errors. The 
Batch Controller recogmzes the existence of an error when it encounters a line beginning with 
a question mark that , s output from the job to the log file or a line that begins with the char- 
acter specified m the . ERROR command. When the error occurs, this command must be the 
next monitor level command in the control file. 



Command Format 



-IF (condition) statement 

(condition) = ERROR or NOERROR. The parentheses must be included. 

statement = an executable monitor or batch command preceded by a period. 

If the specified condition is true, the statement is executed. If the specified conditi 
true, the Batch Controller processes Hie next line in the control file. 



on is not 
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3.4.6 



NOERROR 



Function 



The .NOERROR command instructs the Batch Controller to ignore all errors (including messages 
beginning with a question mark) in the job. This is especially useful in TECO searches. How- 
ever, the message 

?TIME LIMIT EXCEEDED 

always indicates that an error exists. 



Command Format 



NOERROR 



3.4.7 



NOOPERATOR 



Function 



The .NOOPERATOR command designates that no messages from the job are to be output to 
the controlling terminal. 



Command Format 



NOOPERATOR 



3.4.8 



OPERATOR 



Function 



The .OPERATOR command makes it possible for the job, or a program within the job, to com- 
municate with the operator. Any message from the job, starting with the specified character 
(refer to Chapter 4), is typed on the controlling terminal. The job then waits for operator 
intervention and the operator's answer restarts the job. 

(continued on next page) 
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Function (cont) 

When the .OPERATOR command is in effect, the Batch Controller ignores an .IF statement un- 
less the .NOOPERATOR command is given first, and proceeds to search for an error recovery 
routine labeled with either %ERR: or %CERR: (refer to Paragraph 3.4). This action is taken in 
order to minimize output to the operator in case of an unexpected transfer of control. However, 
when an error occurs, the Batch Controller preserves the error status across the .NOOPERATOR 
command and looks for the .IF statement as the next monitor- level command. In other words, 
an .IF statement following a . NOOPERATOR command will be executed. Refer to the follow- 
ing examples. 

In the example below, the -IF statement will be ignored. 

•OPERATOR % 
.RUN TFSPRO 
•IF (ERROR) .GOTO TAG 

However, in the following example, the .IF statement will be executed. 

•OPERATOR % 
.RUN TESPRG 
•NOOPFRATOR 
.IF (FRROR) . 30T0 TAG 

Command Format 

. OPERATOR character 

character = the beginning character of the line that is to be sent to the operator 
(e.g., %). If this argument i$ not specified, $ at the beginning of the line is assumed. 



3.4.9 



.REQUEUE 



Function 



The .REQUEUE command indicates to the Batch Controller that the job is to be requeued, 
instead of terminated, after an error. It is normally used with the .IF (ERROR) command (e.g., 
.IF (ERROR) .REQUEUE). The {ob is restarted after a default requeue time at the specified 
label in the control file. 



Command Format 



REQUEUE label 



Version 6 BATCON 3.30 
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3.4.10 



.REVIVE 



Function 

The .REVIVE command causes all output from the job to be placed in the log file. 

Command Format 
.REVIVE 

3.4.11 



.SILENCE 



Function 



The .SILENCE command suppresses all output from the job except error messages to the log file. 
This means that the only lines appearing in the log file will be those that begin with a question 
mark. * 



Command Format 



.SILENCE 



3.5 JOB OUTPUT 

The output from a user's job is normally in the form of printed listings containing the user's job output, 
compilation listings, any memory dumps requested by the user or initiated by the Batch Controller, and 
the log file indicating the processing performed by the programs in the Batch system. The results from 
the job and the log file are automatically placed in the queue for the line printer spooler, LPTSPL, 
unless the job was submitted with the /OUT PUT.O switch. However, the user can output to any device 
in the system. When a user program specifies a slow-speed spooling device, the Batch system places 
the output into a queue for the appropriate spooler. If the user wishes specific files to be output to 
particular spooled devices outside of his programs, he can include the QUEUE monitor commands in his 
control file to specify the output device and any additional parameters that he wishes. 

Compilation listings are produced from the Slanguage control cards unless the user specifies otherwise. 
These lutings are automatically spooled to the line printer, j The user can also include the COMPILE 
monitor command in his job with switches to produce listings. 
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The user can include any of the monitor DUMP commands or the CDRSTK card $DUMP to request mem- 
ory dumps during program testing. Under normal error conditions, the Batch Controller performs an 
automatic two-page dump for the user (refer to Paragraph 3.4). 

3.5.1 The Log File 

As part of its processing, CDRSTK creates a log file for each job so that the user can examine the 
processing performed by the CDRSTK and BATCON programs. The log file is the first part of the job's 
output. CDRSTK enters a record of its own processing, any errors detected, and any operator inter- 
ventions. When the job is run, the Batch Controller places additional messages into the log file, in- 
cluding each line of the control file as it is passed to the job, any error conditions, and any operator 
actions. The LOGOUT program appends an accounting summary message to the log file when the job 
terminates. This message is similar to the message received when an interactive user logs off the sys- 
tem (refer to the KJOB command in Chapter 2). Note that the log file is appended to for jobs of the 
same name; thus it may be necessary to delete this file before running another job with the same name. 

3.5.1.1 CDRSTK Messages - CDRSTK places six kinds of messages into the log fi le. The first line of 
each message is identified by the time that CDRSTK placed the message into the file and by an iden- 
tifying word in columns 1 through 16. The identifier for each kind of message is taken from the 
following group: 

( DATE — gives the date, system name, CDRSTK version, and the input device. 
STACK — identifies any CDRSTK nonerror message. 
STERR — identifies any CDRSTK error message. 
CARD — describes any card image not in an error message. 

STSUM — identifies the summary message at the end of the CDRSTK's processing. 
STOPR — describes any operator actions that occurred during the CDRSTK's processing. 

The first entry in the log file always contains the identifier DATE and a message giving the date, the 
system name, the current version of CDRSTK, and the input device; for example, 

10:20:06 DATE I3-MAY-71 5S03C System 40 CDRSTK version 7 device CDR1 

The $SEQUENCE and the $JOB commands are the next two lines printed. The ^PASSWORD command 
is never printed for reasons of security. When the end-of-file is read, CDRSTK prints a summary mes- 
sage giving the number of cards read, the number of files and blocks written, and the number of each 
type of error that occurred. The summary is also placed in the system accounting file. An example 
of the job summary is given below. 
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1 1 25:38 STSUM End-of-FMe after 423 cards, 3 fi les (40 blocks) written 
4 Hollerith errors (nonfatal) 
2 Binary Sequence errors (fatal) 
Job Aborted by CDRSTK 

Between the beginning and ending messages, CDRSTK prints any operator actions as they occur, some 
nonerror messages/ and reports of errors it has detected. The following are examples of nonerror mes- 
sages from CDRSTK. 

CARD $JOB TESTA, [10,225] 

STOPR JOB STOPPED BY OPERATOR 

STOPR CONTINUED BY OPERATOR 

3.5. 1 .2 CDRSTK Error Reporting - CDRSTK places messages in the log file that describe errors that 
have occurred during its processing. The following errors are detected, and their degree of severity 
is as specified: 

Fatal Errors 

a. Error on the $J OB card. 

b. Error on the $ PASSWORD card. 

c. Unrecognizable command on a CDRSTK control card. 

d. Error in a parameter on a CDRSTK control card. 

e. Binary sequence error - issued a maximum of five times per deck. 

f. Improper code (binary rather than Hollerith, or vice versa). 



Nonfatal Errors 

a. Hollerith error (invalid punch). 

b. Missing end-of-file card. 

Error messages are issued by CDRSTK to the log file either up to the first fatal error, or, for nonfatal 
errors, up to a maximum of 200 errors or errors on 10% of the total card count, whichever is greater. 
However, CDRSTK continues processing the job up to the end-of-file. The following are examples of 
error messages placed in the log file by CDRSTK. 

JOB ABORTED BY OPERATOR 

JOB ABORTED - HOLLERITH ERRORS 

CARD #nnn FATAL CARD 

CARD # nnn COL # nnn 

CARD #nnn CARD SEQUENCE ERROR 

CARD # nnn SWITCH ERROR 

CARD # nnn MODE ERROR 

NON-BINARY CARD IN BINARY DECK 
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Each card-reading error results in a message which includes the first card column in error, the deck 
number and columns 1 through 30 of the $DECK card, and the card number within the deck and within 
the Job. The faulty card image appears on the next line with a backward slash (\) indicating the col- 



umn in error. 



11 :15:05 STERR Hollerith error at col. 7 of card 241, card 73 in deck 2 ($FORTRAN MAIN) 
3\ORMAT (TOO') 

3.5. 1.3 Batch Controller Messages - The Batch Controller messages are similar to those of the Stacker. 
The times followed by an identifying notation are placed in columns 1 through 16 of the first line of 
each message. The identifiers for the Batch Controller messages are described in the list below: 

BVERS — denotes the version of BATCON. 

BDATE — identifies the date BATCON processed the job. 

BATCH ~ identifies any Batch Controller nonerror message. 

BAOPR — describes any operator action. 

BAERR — denotes any Batch Controller error message: 

MONTR — identifies a line input or output at monitor level. 

USER — describes any line input or output at user level. 

BASUM — gives the Batch Controller summary message. 

The first line in the log file printed by the Batch Controller is the version number. As each line in 
the control file is read, it is printed in the log file as well as being passed to the user program or to 
the monitor. Any time that the operator performs some action that affects the job, the Batch Controller 
records it in the log file. The BATCON program enters a message in the log file every time it generates 
a monitor command. For example, if a fatal error occurs in the job and the user has not included an 
.IF statement, a %ERR routine or a %CERR routine in the control file, the Batch Controller generates 
a DUMP command. It also generates a LOGIN and a KJOB monitor command for each job. 

Any errors in the input that are detected by the Batch Controller are printed in the log file. 

3.5.1.4 Batch Controller Error Reporting - The Batch Controller places the identifier BAERR on any 
line that it detects as being an error. The errors that are detected are listed below; the first three 
are fatal errors. 

a. Missing condition (ERROR or NOERROR) or missing statement in an .IF statement. 

b. Missing statement label in the .GOTO or BACKTO command. 

c The labeled statement in a . GOTO command cannot be found after the . GOTO or before 
the .BACKTO command in the control file. 

d. Use of the ATTACH, DETACH, SEND, CCONT, and CSTART monitor commands. 
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Most user error conditions are not flagged by the Batch Controller, they are passed to the monitor 
where they are flagged as errors. 

3.6 SAMPLE JOBS 

The following sample job setups illustrate the versatility of the Batch System. 

The first example, Figure 3-2, shows a setup to list a card deck with the QUEUE monitor command. 




Figure 3-2 Sample Job m 

The second example, Figure 3-3, produces a CREF listing of a MACRO deck whether or not errors 
occur in the program. 

The third example, Figure 3-4, illustrates the use of error processing commands. 
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Figure 3-3 Sample Job # 2 



A. 



A! ; OR ANYTHING 



■GOTO A 



= TESTX 




IF (ERROR) .GOTO 8 



/* ^TESTX, TESTX/C-+-TESTX. MAC | 




$JOB ERROR [40,32]/NAME:C.KENT 



Figure 3-<4 Sample Job #3 
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Figure .3-5 illustrates d MACRO assembly, two FORTRAN compilations, and execution of all three 
programs, and shows how monitor commands are entered along with the programs and the Stacker 
control cards. 




Figure 3-5 Sample Job "A 
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iFigure 3-6 shows a simple SOUP update. Three base files are copied from cards to disk. The user 
Files are on DECtape and the correction from DEC is on paper tape. 




$ PASSWORD MIKEL 
y^ JOB SUPD[22,567] /AFTERI+ ls" 
f /"^SEQUENCE 840 



Figure 3-6 Sample Job # 5 
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CHAPTER 4 
SYSTEM DIAGNOSTIC MESSAGES AND ERROR CODES 



The following conventions are used in describing the system diagnostic messages: 

dev represents a legal device name. 

file structure name represents a legal file structure name. 

file.ext represents a legal filename and extension. 

adr represents a user address. 

n represents a number. 

a bc represents a disk unit or drive. 

x represents an alphabetic character 

switch represents a switch. 

Most messages returned to the user fall in one of five categories. These categories are determined by 
the beginning character of the message. 

? at the start of the message indicates a fatal error message. 

% at the start of the message represents an advisory or warning message. 

[ at the beginning of the message indicates a comment line. 

$ at the beginning of the message represents an operator/job communication 

line. A response is expected. 

' (quote) at the beginning of the message represents a comment to the operator. 

No response is expected. 

Programs and/or commands causing the error message are given in parentheses. (Note that the ONCE- 
only messages have been removed and placed in ONCE.RNO in the PECsystem-10 So ftware Notebooks.) 
The descriptive text given with the message indicates what action the user should take when he 
receives the message. He can, if necessary, notify the operator of any problems that he is having by 
issuing the SEND, PLEASE, or R GRIPE command. 
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4. 1 SYSTEM DIAGNOSTIC MESSAGES 

The typein is typed back preceded and followed by ? 

The monitor encountered an incorrect character (e.g., a letter in a numeric argument) The 
incorrect character appears immediately before the second ?. 

For example: 

..CORE ABC 
?CORE A ? 

ACCOUNTING SYSTEM FAILURE. . . 

aOG?N m LOGOU°T) aPPend ^ ^ ^ '** aCCOunt?n9 Ble " NoHf / the °P erat01 -- 

? ADDRESS CHECK FOR DEVICE dev 

loolllutT/ mPp C m d ° T addreSS °? a UU ° and found !t to be to ° lar 9 e (>C(. JBREL)) or 
2) Th. SAV i'f'f } ^ in | ° ther f WOr L dS ' the QddreSS ,ies ° utside "» b -"ds of the user program 
(GET) ,S 6 C ° re assigned ' or fhe flle is not a cor e image file. 

$ALL AREAS ON BACKUP 

The BACKUP program has processed all of the project-programmer numbers specified and is 
now closing the associated files. (BACKUP). 

9ALREADY ASSIGNED TO JOB n 

The device is already assigned to another user's fob (job n). v 

? AMBIGUOUS ABBREVIATION 

A command or switch has been abbreviated to the point that it is not unique. (COM PI L). 

7ARGSARE: DAY, RUN, WAIT, READ, WRITE, VERSION, ALL, NONE 

The user either did not type an argument or typed an illegal argument in the SET WATCH 
command string. 

dev: ASSIGNED 

The device has been successfully assigned to the user's job. 

7ASSIGNED TO JOB n , n ... 

If there h ; more than one device of the type specified, the numbers of the other jobs that have 
he same type of device are output, unless the user assigning the device has all Jhe devices of 
the specified type. In this case, 7DEVICE ASSIGNED TO JOB is output. 

? ATTACH TO USER JOB FAILED 

DAEMON could not attach to the user's job. (DAEMON). 
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$ BACKUP COMPLETED AT time 

The BACKUP program has successfully completed. (BACKUP). 

?BAD DENSITY 

The value given with the DENSITY command was not valid. (RESTORE). 

?BAD DIRECTORY FOR DEVICE DTAn 

The system cannot read or write the DECtape directory without getting some kind of error. This 
error often occurs when the user tries to write on a write- locked tape or use a DECtape that 
has never been written on. 

? BATCH ONLY 

The command issued can only be given by a batch job. 

BLOCK NOT FREE 

M specifies a unit or file structure logical block that is not free. (ALCFIL). 

n BLOCKS ALREADY ALLOCATED 

The file already exists. The new specification replaces, rather than updates, the old 
specification. (ALCFIL). 

?nlK BLOCKS OF CORE NEEDED 

Theuser's current core allocation is less than the contents of . JBFF. 

?BOMB OUT 

The location within INITIA that detected the error will be in AC 15 and the console lights. 
(INITIA). 

7BOOTSTRAP LOADER IS NOT IN COPY; TRY /L 

An attempt was made to write the bootstrap loader onto a DECtape via the /T switch before the 
loader was loaded into a core buffer and preserved with the COPY core image. (COPY 
program). 

9BOOTSTRAP LOADER WILL NOT FIT IN 3 BLOCKS 

The user's bootstrap loader is too big to fit into blocks 0, 1, and 2 of the output DECtape. 
(COPY program). 

7BUFFER CAPACITY EXCEEDED AND NO CORE AVAILABLE 

The buffer is not large enough to handle the number of lines required for looking ahead for 
matches, and additional core is not available. (FILCOM). 

?BUSY 

The terminal addressed is not communicating with the monitor (i.e., it is accepting a command 
or returning output from a command). The operator's terminal is never busy. (SEND, JCONT). 
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?CANNOT DO I/O AS REQUESTED 

Input (or output) cannot be performed on one of the devices specified for input (output). For 
example, input may have been requested for a device that can only do output. (FUDGE2). 

7CANNOT DO OUTPUT TO DEVICE dev 

Output was attempted to a device that can only do input, or to a device assigned a logical 
name. (QUEUE). 

?CANNOT PROCESS EXTERNAL SYMBOLS 

External symbols were encountered while loading the bootstrap loader with the /L switch 
(COPY program). 

7CANNOT PROCESS HIGH SEG'S 

While loading the bootstrap loader with the /L switch, high segment code was encountered. 
(COPY program). 

7CANNOT REATTACH FROM A BATCH SUBJOB 

Batch jobs are not allowed to reattach their jobs. (REATTA). 

$%CANT ACCESS COMMAND FILE - CONTINUING 

The command recovery file is not being created. This file contains information as to how much 
of the user's command has been processed and how much is remaining. Without this file, the 
user must start at the beginning if the system crashes. (BACKUP, RESTORE). 

7CANT ACCESS DEVICE dev 

The device specified cannot be INITed. The device is either in use or has an error, such as, 
being off-line. The user should request another device, or check this device for errors 
(BACKUP, RESTORE). 

$%CANT ACCESS INDEX DEVICE - CONTINUING dev 

The device specified for the index file cannot be INITed and an index file is not being 
created. The user can start over if he wants to create an index file. (BACKUP, RESTORE). 

?CANT ACCESS SYSTEM FILES 

ACCT.SYS could not be read. Only the operator may LOGIN until ACCT.SYS is ready. 
Consult the operator. (LOGIN). 

?CANT ADD TO YOUR FILE STRUCTURE SEARCH LIST n 

n is the error code from STRUUO when trying to add a file structure to search list. (LOGIN). 

9CANT ATT TO JOB 

The project-programmer number specified is not that of the owner of the desired job, the 
project-programmer number was not given when it was required, or the PASSWORD'given was 
incorrect. (ATTACH). 
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?dev CANT BE REASSIGNED 



(1) The job's controlling terminal cannot be reassigned, or (2) the logical name would be dup- 
licated, or (3) the logical name is a physical device name in the system and the job reassign- 
ing the device is either logged-in under a different project-programmer number or does not 
have operator privileges. (REASSIGN). 

7CANT CONTINUE 

The job was terminated due to (1) all ERROR IN JOB messages (except for HALT), (2) the 
EXIT UUO, (3) the CLOSE command, or (4) the REA command when the device was INITed, 
and the user attempted to continue his program at the point at which I/O was terminated. The 
job cannot be continued. 

CANT CREATE NEW FILE STRUCTURE SEARCH LIST 

The monitor cannot create a new file structure search list. 

7CANT DECIPHER COMMAND 

The command typed isnot recognized by the BACKUP program. (BACKUP, RESTORE). 

?CANT DECIPHER THAT 

There is a syntax error in the command string. (MOUNT, DISMOUNT, FILE). 

7CANT DET DEV 

The user is not logged-in under [1,2]. 

7CANT ENTER OUTPUT FILE n file descriptor 

The ENTER to write the output file failed; n is the disk error code. (DUMP). 

7 CANT EXPAND TABLE xxxx 

The DUMP program ran out of core in attempting to expand the indicated table. (DUMP). 

7CANT FIND INPUT FILE n file descriptor 

DUMP cannot locate the file specified as the input file; n is the disk error code. (DUMP). 

7CANT FIND FILE file. ext 

The specified file could not be found. 

7 CANT GET SWAPPING PARAMETERS 

DAEMON tried to obtain the job's swapping parameters and failed. (DAEMON). 

7CANT GET SWAPPING POINTER FOR JOB 

DAEMON tried to obtain the pointer to the user's job on the swapping space and could not 
- because the GETTAB UUO failed. (DAEMON). 
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?CANT GET USERS PPN 

DAEMON tried to obtain the user's project-programmer number and could not because a 
GETTAB UUO failed. (DAEMON). 

?CANT OPEN fi le structure name 

The file structure is mounted but cannot be opened. No UFD is created, though one may 
already exist. (LOGIN). 

?CANT OPEN CHANNEL FOR DEVICE dev 

The OPEN on the channel for the named device failed. (BACKUP, RESTORE). 

?CANT OPEN DEVICE dev 

The specified device does not exist or it is assigned to another user . (DAEMON). 

?CANT OPEN INDEX FILE 

The OPEN failed for the index file.. (BACKUP, RESTORE). 

?CANT OPEN SWAP UNIT abc 

DAEMON attempted to use the indicated swapping unit and failed. (DAEMON). 

?CANT RELEASE UFD INTERLOCK FOR dev [ P/ p] 

The UFD interlock cannot be released for the. named device. (BACKUP). 

?CANT RENAME -FILE PRESERVED 

An attempt was made via the /DISPOSE:RENAME switch to delete a preserved file (i.e., a 
file whose owner's field is greater than 0). (QUEUE). 

?CANT SET OUR SEARCH LIST 

DAEMON tried to set its search list and failed in its attempt. (DAEMON). 

?CANT SET SEARCH LIST = USER'S 

DAEMON attempted to set its file structure search list to be the same as the user's search list. 
(DAEMON). 

7COMMAND ERROR 

General catch-all error response for most commands. The syntax of the command is in error, 
and the command cannot be deciphered. 

In FILCOM, one of the following errors occurred in the last command string typed. 

1 . There is no separator (*• or =) between the output and input specifications. 

2. The input specification is completely null. 

3. The two input files are not separated by a comma. 

4. A file descriptor consists of characters other than alphanumeric characters. 

(continued on next page) 
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5. FILCOM does not recognize the specified switch. 

6. The project-programmer number is not in standard format, i.e., [proj,prog]. 

7. The value of the specified switch is not octal. 

8. The first input file is followed by a comma but the second input file is null. 

? COMMAND SYNTAX ERROR 
TYPE /H FOR HELP 

An illegal command string was entered. (GLOB). 

7COMMA REQUIRED IN DIRECTORY 

' A project-programmer number has been specified without the separating comma. 
(DUMP, QUEUE, BACKUP, RESTORE). 

CONT BY OPR 

The job has been continued by the operator. This message appears on the console of the job 
being continued. (JCONT). 

7CONTROL AND LOG FILES MUST BE DISTINCT 

a 

The control file cannot be the same file as the log file. (QUEUE). 

?2K CORE NEEDED AND NOT AVAILABLE 

FILCOM needs 2K of core to initialize I/O devices and this core is not available from the 
monitor. (FILCOM). 

%CPUn OPR1 ACTION REQUESTED 

The Job's CPU specification includes a CPU which is not running or is not scheduling jobs. 
The monitor remembers the specification and uses the CPU as soon as it is started. If at least 
one GPU is running, the message is printed only once, since the job can run on another CPU. 

7DAEMON FILE MUST BE WRITTEN ON A DISK 

The device specified was a nondisk device. (DAEMON). 

7DAEMON NOT RUNNING 

The DAEMON program has not been initialized. It must be started by the operator to allow 
the DUMP and DCORE commands to operate. (DUMP, DCORE). 

9DETACH UUO FAILED 

DAEMON could not detach itself from the TTY. Note that DAEMON does not detach itself 
if it is loaded with DDT. (DAEMON). 

?DATA ERROR ON DEVICE PTR 

A read error has occurred on the paper-tape reader. (COPY program). 
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7DESTINATION DEVICE ERROR 

An I/O error occurred on the output device. (GLOB). , 

7DEVICE CANT BE REASSIGNED 

(1) The job's controlling terminal cannot be reassigned, (2) the logical name would be dupli- 
cated, or (3) the logical name is a physical device name and the job reassigning the device is 
either logged in under a different project-programmer number or is not the operator. 

? DEVICE ERROR ON OUTPUT DEVICE 

A write error has occurred on the output file. (FUDGE2). 

7DEVICEINIT FAILURE 

The specified device has been assigned to another job or does not exist. (COPY program). 

7DEVICE MTAn NEEDS A WRITE RING, INSERT ONE AND TYPE <CR> 
This message is returned by the BACKUP and RESTORE programs. 

? DEVICE MUST BE A DECTAPE 

The only device that can be specified in the COPY command string is the DECtape. (COPY 
program). 

? DEVICE dev NOT A DIRECTORY DEVICE 

This message is returned by the BACKUP program. 

?DEVICE NOT ASSIGNABLE 

A non-privileged user cannot assign the requested device because it belongs to the restricted 
pool of devices. The user should try to assign the device with the MOUNT command. 
(ASSIGN). 

7 DEVICE NOT AVAILABLE 

Specified device cannot be initialized because another user is using it or because it does not 
exist. 

? DEVICE WILDCARD ILLEGAL 

The wildcard construction cannot be used in the device specification. (DUMP, QUEUE 
BACKUP, RESTORE). 

7DIALOG MODE NOT SUPPORTED 

The capability of interactive dialogue with the user has not been implemented. (QUEUE). 

7DIRECTORY FULL ON OUTPUT DEVICE 

There is no room in rhe file directory on the output device to add the updated file (nondisk 
devices only). (FUDGE2). 
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device name DISMOUNTED 

The DISMOUNT command has completed. 

?device name DISMOUNT INCOMPLETE 

The DISMOUNT command was unsuccessful. In most cases, the reasons for failure have already 
been listed by nonerror messages. 

DONT KNOW CTY LINE NUMBER 

The DCORE command cannot be typed on CTY. (DAEMON). 

7DOUBLE DEVICE ILLEGAL 

Two device names appeared in a row without an intervening filename, or two colons appeared 
in a row, e.g., LPTrPTP: or DSKA ::FI LEX... (DUMP, .QUEUE). 

7DOUBLE DIRECTORY ILLEGAL 

Two directory names cannot appear without an intervening filename. (DUMP, QUEUE). 

7DOUBLE EXTENSION ILLEGAL 

Two extensions cannot appear without an intervening filename or comma. (DUMP, QUEUE). 

7DOUBLE FILENAME ILLEGAL 

Two filenames appeared in a row, or two periods appeared in a row; e.g., Q TEST1 TEST2 or 
TEXTX.. MAC. (DUMP, QUEUE). 

DPAn NO DRIVE AVAILABLE ON THIS CONTROLLER 

The drives on the specified controller are all in use. (MOUNT). 

?DSK CANT BE REASSIGNED 

An attempt was made to reassign the prototype disk device data block (DDB). 

7DSKCHR FAILURE n ON UNIT abc 

The DSKCHR UUO gave an unexpected error return; n is the disk error code. Notify the 
operator. (DAEMON, KJOB). 

%END OF TAPE id ON dev 

PLEASE MOUNT TAPE id+1 AND TYPE <CR> TO CONTINUE: 

This message is sent to the operator. (RESTORE). 

%END OF TAPE id ON dev 

PLEASE MOUNT NEXT TAPE AND TYPE <CR> TO CONTINUE 

This message is sent to the operator. (BACKUP). 
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%END OF TAPE n ON MTAn AT time 

The end of the tape has been reached. (RESTORE). 

Cdpa\ 

SEND OF TAPE n ON < MTA > x AT time 
[PSKJ 

This message appears in the log file. (BACKUP). 

?ENTER ERROR n 
?DIRECTORY FULL 

No additional files can be added to the directory of the output device; n is the disk error code. 
(GLOB). 

?ENTER FAILURE 

The DECtape directory is full (I.e., there is no room for the file to be written on the DECtape). 

?ENTER FAILURE n 

The output filename is null; n is the error code for an illegal filename (nondisk devices only) 
(FUDGE2). //- 

?ENTER FAILURE FOR INDEX FILE 

The ENTER failed for the index file. (BACKUP). 

7ENTER FAILURE IN QUEUE MANAGER 

QUEUE was unable to enter the files into the output queue. (QUEUE). 

?ENTERFAILURE " ON {daemon} FILE 

The ENTER to write the file failed; n is the disk error code. 

9ENTRY BLOCK TOO LARGE PROGRAM name 

The entry block of the named program is too large for the FUDGE2 entry table, which allows 
for 100 entry names. FUDGE2 can be reassembled with a larger table. (FUDGE2). 

7ERROR CLOSING OUTPUT, STATUS = n 

An I/O error occurred while closing the file on disk; n is the disk error code. (DUMP). 

?ERROR IN JOB n 

A fatal error occurred in the job or in the monitor while servicing the job. This typeout 
usually precedes a one-line description of the error. 
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? EXCEED LOG-OUT m QUOTA BY n BLOCKS 

The total number of blocks for all the user's files exceeds the maximum permitted value (m) by 
the indicated amount n. The user may use PIP or the DELETE command to remove files. Until 
the user is under the limit, he cannot dismount the file structure. (DISMOUNT). 

7EXECUTION DELETED 

A program is prevented from being executed because of errors detected during assembly, com- 
pilation, or loading. Loading is performed, but the loader exits to the monitor without start- 
ing execution. (LOADER). 

7EXPECTED FORMAT IS "NNNK" = 16K to 256K 

The core-bank specified while processing the /T switch is not within the acceptable range or 
does not terminate with the letter K; e.g., 32 is not acceptable; 32K is. (COPY program). 

%FAILUREON fe^f} FOR ERROR FILE-CONTINUING 

The error file could not be generated. The BACKUP program is continuing without one. 
(BACKUP). 

7FAILURE ON V^]^ FOR LOG FILE 

The log file could not be generated. (BACKUP, RESTORE). 

%FAILURE OUTPUTTING ERROR FILE— CONTINUING 

The error file could not be output. The BACKUP program is.continuing its processing. 
(BACKUP, RESTORE). 

%FAILURE (coating} UFD F ° R deV [ P ro i'P rogl 

The UFD for the named device could not be read (BACKUP) or created (RESTORE). 

%FAILURE TO INTERLOCK UFD FOR dev [proj,prog] 

The UFD interlock for the named device failed. (BACKUP). 

file structure name FILE ERRORS EXIST 

One of the files in a file structure has an error status, as flagged in the UFD of that file 
structure. (LOGIN). 

9FILENAME ALREADY IN USE 

The specified file already exists. (COMPIL). 

7FILENAME REQUIRED FOR INPUT QUEUE 

A file cannot be entered into the Batch input queue without a filename. (QUEUE). 
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?FILE n NOT IN SAV FORMAT 



The user indicated via the /X switch that the file is to be expanded but the specified file is 
not in compressed fi le format. N is either 1 or 2 indicating the first file or the second file. 
(FILCOM). 

?FILEn READ ERROR 

An error has occurred on either the first or second input device. (FILCOM). 

?FILE SWITCHES ILLEGAL IN OUTPUT FILE 

File switches cannot appear on the left of the equal sign, i.e., in the output specification. 
(QUEUE). 

?(3) FILE WAS BEING MODIFIED-file.ext 

Another user is modifying the file. (COMPIL). 

?(0) FILE WAS NOT FOUND-file.ext 

The named file could not be located. (COMPIL). 

7FORMAT OR READ ERROR IN AUXACC.SYS 

LOGIN unexpectedly found an end-of-file or an error in AUXACC.SYS. Notify the ooerator 
(LOGIN). X P 

file.ext FOUND BAD BY FAILSAFE READING MTA 

The file in the file structure has an error status as flagged in the UFD of the file structure 
(LOGIN). 

FROM JOB n 

An informative message telling the user the job number to which the console was attached or 
from which the console is detaching. (ATTACH, DETACH). 

7FUDGE2 SYNTAX ERROR 

An illegal command string was entered; for example, the left arrow was omitted or a program 
name was specified for the output file. (FUDGE2). 

? GIVING BACK TOO MUCH CORE 

An internal problem in the DUMP program. Notify your system programmer or software 
specialist. (DUMP). 

?HALT AT USER adr 

The user's program executed a HALT instruction at adr. Typing CONTINUE resumes execution 
at the effective address of the HALT instruction. 
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fi le ext HARDWARE DATA READ ERROR DETECTED 

The file has a hardware data read error flagged in the UFD of the file structure. (LOGIN). 

file. ext HARDWARE DATA WRITE ERROR DETECTED 

The file has a hardware data write error flagged in the UFD of the file structure. (LOGIN). 

?HUNG DEVICE dev 

If a device does not respond within a certain period after it is referenced, the system dec.de. 
that the device is not functioning and outputs this message. 

?ILLEGAL BACKUP DEVICE , RA ™.P^ 

The BACKUP operations can be done only on disk, magnetic tape, and DECtape. (BACKUP). 

7ILLEGAL BLOCK TYPE 

While loading the bootstrap loader with the /L switch, an unrecognizable block type was en- 
countered by COPY . (COPY program). 

^ILLEGAL COMMAND SYNTAX CHARACTER x 

The character x is used incorrectly in the command string. (QUEUE, BACKUP). 

ILLEGAL DATA MODE FOR DEVICE dev AT USER adr 

The data mode specified for a device in the user's program is illegal, such as dump mode for 
the terminal. 

?drive ILLEGAL DRIVE NAME # 

The drive specified by the user is in conflict with the unit or controller type reared by the 
units of the file structure. (MOUNT). 

7ILLEGAL IN BATCH JOB 

The ATTACH, DETACH, SEND, CCONT, and CSTART monitor commands cannot be used by a 

batch job. 

7ILLEGAL JOB NUMBER 

The job number is too large or is not defined in this configuration. 

7ILLEGAL QUEUE DEVICE 

The queue name specified cannot be used with the given switch. (QUEUE). 

7ILLEGAL QUEUE NAME xxx , ft iiFim 

The queue is not one of the system queues, or the queue is a logical name. (QUEUE). 
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?ILLEGAL TO CREATE REQUEST FOR SOMEONE ELSE 

Only the operator logged in under 1,2 con create queueing request for other users. (QUEUE). 
?I LLEGAL UUO AT USER adr 

An illegal UUO was executed at user location adr. 

9ILLINST. AT USER adr 

An illegal operation code was encountered in the user's program. 

?ILLMEMREFATUSERadr 

^X: e e l^ [1Z7sZZ T d& ^t USer ' S Pr09ram ' " thh "^ ™ d on a 
red onYmeX L ° Z^tlZV^Z^ T? ^V"" ^"^ If * «*- 
use the E command ton*J^£tL£^l " 57? f ° CaH ° n **' The USer shou,d 
- Mlegal instruction. TU^^^^^^X^^ ^Z^J" °* * <"« 

?INDEX FILE CANNOT GO TO A LISTING DEVICE 

This message is returned by the BACKUP and RESTORE programs. 

?INPUT AND OUTPUT DECTAPES MAY NOT BE THE SAME DEVICE 

The COPY program performs its operations on an input DECtape and an output DECt a ™ TU 
DECtapes cannot be the same. (COPY program). ' P UtLtape. These 

?INPUT (or OUTPUT) BLOCK TOO LARGE 

A DECtope block number greater than HOlg was encountered. (COPY program). 
7INPUT (or OUTPUT) CHECKSUM OR PARITY ERROR 

A read (or write) error has been detected. .(COPY program). 

?INPUT DEVICE dev CANNOT DO OUTPUT AT USER adr 

Output was attempted on a device that can only do input (e.g., the card reader). 
?INPUT (or OUTPUT) DEVICE ERROR 

The DECtape control unit has detected the loss of data or a missed block. (COPY program). 
?INPUT DEVICE NOT A DISK 

The input specifications in a QUEUE command must be disk files. (QUEUE). 
?INPUT ERROR 

t^Tcom^ Wh " e re ° din9 ' temp ° rory ™ ,d file f ™ *• *fc- Hie should be 
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?INPUT ERROR - file.ext FILE NOT FOUND 

The specified file could not be found on the input device. (FILCOM). 

ffile.UFD^ 
%INPUT ERROR DSKn / file. MFD) [proj,prog] 
\file.SFDj 

The BACKUP program cannot access the entries in the named directory. These entries will not 
be saved on the BACKUP medium . The BACKUP program continues by advancing to the next 
directory. (BACKUP). 

?INPUT ERROR, STATUS = n 

An I/O error occurred while reading the file from disk; n is the disk error code. A new INPUT 
command causes a new LOOKUP to be done. (DUMP, DAEMON). 

7INPUT FAILED FOR RLE DSKn file.ext [proj,prog] 

The INPUT fai led for the specified file. (BACKUP, RESTORE). 

?INPUT (or OUTPUT) PREMATURE END OF FILE 

When copying a DECtape, COPY encountered the end of file before it expected it. This may 
happen when copying a PDP-9 DECtape to a PDP-10 DECtape. (COPY program). 

?INSUFFICIENT CORE FOR QUEUE 

There is not enough core in system at the time of the KJOB command to make an output queue 
entry. (QUEUE). 

7INVALID ARGUMENT 

The argument specified on a BACKSPACE or PARITY command is unknown. (BACKUP, RESTORE). 

7INVAL1D ENTRY - TRY AGAIN 

# 

An illegal project-programmer number or password was entered and did not match identification 
in system. The user is to retype his project-programmer number and password. (LOGIN). 

?I/0 TO UNASSIGNED CHANNEL AT USER adr 

An attempt was made to do an OUTPUT, INPUT, OUT, or IN to a device that the user's pro- 
gram has not initialized. 

^.,,.r^A, /CHARACTER^ 
?x IS AN ILLEGAL | SWITCH J 

An illegal character or switch was encountered in the command string. (FUDGE2). 

?symbol IS A MULTIPLY DEFINED LOCAL 

The named symbol is in more than one symbol table with different values. (DUMP). 
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?symbol IS AN UNDEFINED SYMBOL 

The named symbol is not in DUMP's symbol table. (DUMP). 

?symbol IS AN UNDEFINED SYMBOL TABLE NAME 

The named symbol table has not been loaded with an XTRACT command. (DUMP). 

?JOB CAPACITY EXCEEDED 

This message is received by a user who attempts to login after the maximum number of jobs that 
the system has been set to handle has been initiated. The user should loqin in at a later time 
(LOGIN). 

?JOB NOT WAITING 

The job specified is not waiting to be continued. (JCONT). 

JOB SAVED 

The output is completed. 

JOBn USER [ P/ p] LOGGED OFF TTY n AT hhmm dd-mm-yy 
DELETED <ALL> n FILES 

SAVED <ALL> n FILES m TOTAL BLOCKS USED 
ANOTHER JOB STILL LOGGED IN UNDER [p,p] 
RUNTIME n MIN m SEC 

This information is typed as user logs off successfully. Note that m is total blocks allocated as 
opposed to blocks written. Therefore, it is always greater than or equal to the number of 
blocks written. File's are allocated in units of blocks called clusters. The system administra- 
tor selects the cluster size for each file structure, usually one block per cluster for FH file 
structures, and 5 or 10 blocks per cluster for DP file structures. (KJOB). 

? LANGUAGE PROCESSOR CONFLICT 

The use of the + construction has resulted in a mixture of source languages. (COMPIL). 

?LEVELD ONLY 

The command issued is available only in 5-series monitors. 

? LINKAGE ERROR - RUN UUO 

An I/O error occurred while reading a program from the device SYS:. (COMPIL). 

%USTING DEVICE OUTPUT ERROR, STATUS = 

The device specified for the output has an error. A new OUT command selecting a new file 
can be given or an OUT and APPEND command sequence to try again. (DUMP). 

7USTING ENTER FAILURE n 

The ENTER to write the output file failed; n is the disk error code. (QUEUE). 
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? LISTING OPEN FAILURE ON DEVICE dev 

The OPEN failed on device dev. (QUEUE). 

7LOCKED-OUT BY OPERATOR 

The operator is preventing any new accesses to the file structure in order that it may be re- 
moved. (MOUNT). 

file structure name LOGGED OUT QUOTA n EXCEEDED BY m BLOCKS 

The user's allocation on the file structure named is greater than his logged out quota. The user 
must go through the CONFIRM dialogue and delete files until he is under the quota allowed to 
log off. (KJOB, LOGOUT). 

%LOGICAL NAME WAS IN USE, DEVICE dev ASSIGNED 

The user previously assigned this logical name to another device. The logical name is cleared 
from the first device and assigned to the second. 

? LOGIN PLEASE 

A command that requires the user to be logged in has been typed to the monitor; it cannot be 
accepted until the user performs a LOGIN. 

? LOGIN PLEASE TO USE SWITCH CREATE 

The user must be logged in to make a new entry into a system queue. (QUEUE). 

? LOOKUP ERROR n 
?file.ext FILE NOT FOUND 

The named file cannot be found in the directory on the specified device. (GLOB) 

%LOOKUP ERROR DSKn file [proj,prog] 

The BACKUP or RESTORE program cannot access the indicated file and continues by skipping 
to the next file. (BACKUP, RESTORE). 

9LOOKUP FAILED, "BSLDR.REL" 

While processing the/L switch, COPY could not find the bootstrap loader named BSLDR.REL. 
(COPY program). 

? LOOKUP FAILURE 

The LOOKUP to read the disk file failed. This message is followed by a line explaining the 
reason for failure. (FUDGE2). 

?file structure name LOOKUP FAILURE n 

The LOOKUP to read the fi le fai led; n is the disk error code . 
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7LOOKUP FAILURE FOR INPUT FILE n file 

DUMP cannot read the input file. (DUMP). 

? LOOKUP FAILURE n ON DAEMON FILE 

The LOOKUP to read the DAEMON file failed; n is the disk error code. (DAEMON). 

?MAX = n 

PUMP) WOS SPeC " f!ed f ° r a " araument that is 9 reat er than the maximum value (n) allowed. 

?MAY NOT LOGIN AS MFD PPN 

(LOGIN)™ '° 9in Q!! [1 ' 1] t>eCaUSe tHlS nUmber iS fhe P ro i ecf -P r °9'-ammer number of the MFD. 



f! 



LOCAL 
. REMOTE 
?MAY NOT LOGIN/ DATA SET 

BATCH JOB SUB JOB f 
REMOTE CTY OR OPRJ 

be^u!^ TogIn) ^ PermIf thS pr °' ect -P r °9 ramrner number to logm at the terminal that is 

?MAY NOT LOGOUT WITH FILE STRUCTURES FOR LOGICAL NAMES 

A file structure in the job's search list is assigned a logical name, and only physical device 
names are recognized. The user should deassign the logical names. (KJOB, LOGOUT). 

?MEM PAR ERROR AT USER PC adr 

The processor detected a memory parity error in the low or high segment while the job was exe- 
cuting. The adr „ the address of the PC stored by the hardware rather than the user address of 
the parity error. Ihe operator also receives an error message giving the range of absolute ad- 
dresses in case memory reconfiguration is necessary. DAEMON is awakened in order to record 
the pertinent information about the error for field service personnel. 

The user must start a new copy of his program by typing the appropriate monitor command R, 
RUN, or GEL He should not start the program over by typing START, since the error is likely 
to reoccur or the-program operate with incorrect data. 

The MFD cannot be accessed. (BACKUP). 
?MORE THAN ONE [ J^™ 1 } DEVICE I LLEGAL 

SaCKuV?ReTtORE) P 0perati ° nS CCm be taken from or wrltten to on| y one device at a time. 
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?MORE THAN ONE OUTPUT FILE ILLEGAL 

Only one output queue-name may be specified in the QUEUE command String. (QUEUE). 

device MOUNTED 

The device is mounted and ready for use. The MOUNT command has completed. If a file 
structure was mounted, a list of the unit ID's and the drives on which they are mounted is 
output. (MOUNT). 

?device MOUNT INCOMPLETE 

The MOUNT command has not completed successfully. In most cases, the reasons for failure 
have already been listed by nonerror messages. In a Batch job, MOUNT INCOMPLETE not 
preceded by a message may indicate that the user is attempting to mount a spooled device 
without executing a SET SPOOL command to unspool the device. The user must have 
unspool privileges in his accounting file entry in order to unspool and mount spooled devices. 

?MUST BE IN OWNER'S PROJECT FOR SINGLE ACCESS 

The user may not request single-access (/SINGLE switch) unless he has the same project num- 
ber as the owner of the file structure. This requirement is enforced since a user with single 
access may execute super-USETI/USETO UUOs. (MOUNT). 

name MUST NOT BE A LOGICAL NAME 

The structure named contains the operator request queue (3,3. UFD) and must not be the logical 
name for some other structure. (MOUNT). 

?file structure name MUST NOT BE WRITE-PROTECTED 

The named structure is being used to queue requests to the operator and therefore may not be 
write-protected, SETSRC may be used to change the protection. (MOUNT, DISMOUNT, 
FILE). 

NAME: 

The ACCT.SYS entry for this project-programmer number requires the user to type a name which 
matches the one in ACCT.SYS in order to login. (LOGIN). 

?NEED 5.03 OR LATER FOR REATTACH COMMAND 

The REATTA program depends on UUOs available in the 5.03 release of the monitor. The user 
attempted to run the program using an older monitor. (REATTA). 

?NESTING TOO DEEP 

The @ construction exceeds a depth of nine and may be due to a loop of @ command files. 
(COMPIL). 

?NO CORE ASSIGNED 

No core was allocated when the GET command was given and no core argument was specified 
in the GET. 

NO DIFFERENCES ENCOUNTERED 

No differences were found between the two input files. (FILCOM). 
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?(1) NO DIRECTORY FOR PROJECT-PROGRAMMER NUMBER - file.ext 

A UFD does not exist for the requested project-programmer number. (COMPIL). 

?NO END BLOCK ENCOUNTERED 

The last block of the bootstrap loader program must be an end block (refer to the MACRO 
manual). (COPY program). 

?NO ENTRY IN AUXACC.5YS 

NO SEARCH LIST OR UFDS CREATED 

If the user has no entry in AUXACC.SYS, LOGIN does not create UFDS or a search list. User 
is logged-in and has UFDs if they existed previously. He may write only on file structures that 
have UFDs or read all file structures. He may also create a file structure search list with 
SETSRC. The user can create UFDs on those file structures for which he has an entry in 
QUOTA. SYS by using the MOUNT command. (LOGIN). 

NO ENTRY IN QUOTA. SYS 

The user may utilize the file structure, but no UFD is created if he does already have one 
(MOUNT). y 

%NO INFO ON "name" 

The user specified a feature that has no available documentation. (HELP). 

?NO INPUT DEVICE SPECIFIED 
SPECIFY INPUT DEVICE NOW: 

An input device name was not specified prior to the START command. (RESTORE). 

?NO MODIFIER ALLOWED IN SWITCH switch 

The switch specified cannot have an argument. (QUEUE). 

NONE PENDING 

None of the user's requests to the operator are pending. 

7NON-EXISTENT DRIVE DPAn 

The user has specified a drive that does not exist in the system. (MOUNT). 

%NON-EXISTENT FILE input specification 

The file specified for input could not be found. This message is not output if the /NEW switch 
is specified for the file. (QUEUE). 

7NON-EX MEM AT USER adr 

Usually due to an error in the monitor. 
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?NO OPR. JOB FOR THIS REQUEST 

An operator request has been issued, but there is no OMOUNT running and enabled to service 
the request. The request is sti II queued unless the /PAUSE switch was given. 

?NO OUTPUT DEVICE SPECIFIED 
SPECIFY OUTPUT DEVICE NOW: 

An output device name was not specified prior to the START command. (BACKUP). 

?NO PRIVILEGES TO SET CPU 

The user does not have the privilege bits set by LOGIN from ACCT.SYS to change the CPU 
specification. The user should request that these privilege bits be set by the system manager. 

?NO PRIVS TO UNSPOOL 

The user does not have privileges to unspool devices, and the operator has not set bit 28 in the 
STATES word. 

?NO REMOTE USERS. TRY AGAIN LATER 

The operator has used the SET SCHEDULE command to prevent LOGINs from remote terminals. 
The message of the day is still typed. (LOGIN). 

NO ROOM IN QUEUE, TRY AGAIN LATER 

There is no room in the queue for the user's request to be sent to the operator. (MOUNT). 

?(14) NO ROOM OR QUOTA EXCEEDED - file.ext 

There is no room on the file structure or the user's quota on the file structure has been exceeded. 

%NO RUNNING CPUS IN SPECIFICATION 

If none of the CPUs in the job's CPU specification are running, the user receives this message 
every minute until the CPU is started or he types a new SET CPU command. 

?NO START ADR 

Starting address or reenter address is zero, because the user failed to specify the starting ad- 
dress in the END statement of the source program or in the START command. However, an im- 
plicit starting address of may be specified. 

?NO SUCH DEVICE 

The device name does not exist or was not assigned to this job. 

?NO SUCH JOB 

An attempt was made to attach to a job that has not been initialized. 

?NO SUCH STR 

A nonexistent file structure was specified. (KJOB). 
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?NO SUCH TTY 

The terminal number is not part of the system configuration. 

?NO SUCH UNIT 

The unit does not exist or all units of this type are in use. 

7NOTAJOB 

The job number is not assigned to any currently running job. (ATTACH, DSK, JCONT). 
There is no job logged in at this terminal. (CONTINUE). 

?NOT A SAVE FILE *» 

The file is not a core image file. 

?NOT A SPOOLING DEVICE 

The device specified is not one of the spooling devices (LPT, CDP, CDR, PTP, PLT). 

?NOT ASTR- TRY AGAIN 

The file structure specified is not recognized by the monitor. 

?NOT A TTY 

The device name given is not a terminal. (REATTA). 

?drive NOT AVAILABLE 

The drive indicated by the user is not currently available. (MOUNT). 

?command NOT CODED 

A command that is not in this version of DUMP was specified in the command string. (DUMP). 

?NOT ENOUGH ARGUMENTS 

An insufficient number of files of one type has been specified. (FUDGE2). 

?NOT ENOUGH CORE 

The system cannot suppl/ enough core to use as buffers or to read in a system program, 
(COMPIL). 

NOT ENOUGH DRIVES AVAILABLE 

There are currently not enough drives of the right type to mount the file structure. (MOUNT). 

NOT ENOUGH TABLE SPACE FOR SWAPPING UNITS 

There are more swapping units than DAEMON allowed for. DAEMON should be reassembled 
(DAEMON). 
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?dev file. ext program NOT FOUND 

The file or the program was not found on the device or in the file specified. If a program name 
is printed, this message may indicate that the program names in the command string appear ,„ 
a s P equence different from their sequence within the file. Therefore, the program may actua I ly 
exilt but was missed because of the incorrect sequence in the command string. (FUDGED. 

?file.SAV NOT FOUND 

The program file requested cannot be found on the system device or the specified device. 

drive NOT READY 

The indicated drive is either off-line or physically write-locked when write-enabled was re- 
quested. The operator will be notified. (MOUNT). 

?NOT YET SUPPORTED COMMAND CODE switch 

A switch has been specified that is not implemented. (QUEUE). 

NO UFD CREATED 

The user may access the file structure, but he cannot write in his disk area since he has no 
UFD. (MOUNT). 

?NULL DEVICE ILLEGAL 

A colon has been found without a preceding device name. (QUEUE, BACKUP, RESTORE). 

?NXM adr 

While computing the value of an expression, a non-existent location was specified when 
referencing the input file. (DUMP). 

?nk OF CORE NEEDED or ?nP OF CORE NEEDED 

There is insufficient free core to load the fi les; n is the size being requested for the segment 
that fai led (either high or low segment, not the sum of the high and low segments) This mes- 
sage occurs when the virtual core for the system has been exceeded or the core for this ,ob has 
been exceeded. The user should type CORE J to determine what core has been exceed ed and 
whether the high or low segment was too big. K denotes 1024 words which is the unit of co e 
allocation on a KAlO-based system, and P denotes 512. words (one page) which is the unit of 
allocation on a KHO-based system. 

? OFFSET = 1000 TO 777600 (OCTAL) 

The offset specified by the user is not within the acceptable range. (COPY program). 

?ONLY BATCH USERS MAY LOGIN. TRY AGAIN LATER 

The operator has used the SET SCHEDULE command to prevent LOGINs, except for BATCH 
jobs. The message of the day is still typed. (LOGIN). 
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?OPEN FAILED FOR DEVICE dev 

The OPEN for the named device failed. (BACKUP, RESTORE). 

?OPEN FAILURE ON DATA DEVICE dev 

The OPEN on the specified device failed. (DUMP). 

OPERATOR BUSY, HANG ON PLEASE. 

The user must wait for the operator to become available. 

OPERATOR NOTIFIED 

(1) The operator is available and the user may continue typing his message. (PLEASE). 

W A request .s queued to the operator to perform a specified action. (MOUNT, DISMOUNT). 

OPERATOR REQUESTED TO MOUNT UNITS 

(MOUNT)! 5 qUeUed t0 thG ° Perat ° r f ° m ° Unt Qnd r6ady fhe Packs ° n the P r °P er drives ' 
OPERATOR REQUESTED TO READY DRIVES 

^^.ts^r* 1 ** by previous messa9es) are not ready - a request iS queued *> 

OPERATOR REQUESTED TO REMOVE PACKS 

A request to physically remove the packs has been queued to the operator. (DISMOUNT). 
OTHER USERS - CANNOT SINGLE ACCESS 

switch "(TUNC* . n rre TU ,y US . F T h6 fIle SfrUCture thaf has been s P ecified ^th the single-access 
switch (/SINGLE). The switch is ignored. (MOUNT). y 

OTHER USERS - CANT REMOVE 

A DISMOUNT command requesting physical removal (/REMOV switch) of a pack has been 
.■sued and there are other users of the pack. The switch Is ignored. (DISMOUNT) 

OTHER USERS SAME PPN 

A program has determined that other jobs are currently logged-in under the same proiect- 
programmer number. (LOGIN, KJOB). pro|ect- 

?OUT OF BOUNDS 

The specified adr is not in the user's core area, or the high segment is write-protected and th. 
user does not have privileges to the file that initialized the high segment, (d'e) 

?OUTPUT DEVICE dev CANNOT DO INPUT AT USER adr 

An attempt was made to input from an output device (e.g. , the line printer). 
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? OUTPUT DEVICE ERROR 

An error has occurred on the output device. (FILCOM). 

? OUTPUT ERROR 

An I/O error occurred while writing a temporary command file on disk. (COMPIL). 

? OUT PUT ERROR, STATUS = n 

An I/O error occurred while writing the file on disk; n is the disk error code. (DAEMON). 

?OUTPUT INITIALIZATION ERROR 

The output device cannot be initialized for one of the following reasons: 

1 . The device doe not exist or is assigned to another job. 

2. The device is not an output device. 

3*. The file cannot be placed on the output device. (FILCOM). 

PASSWORD: 

The user must type a PASSWORD which matches that in the ACCT.SYS entry for this project- 
prcValer J^r. Echoing is suppressed to preserve PASSWORD security If the user ,s at a 
half-duplex (local copy) terminal, this message is replaced by a sequence of random over-typed 
characters, over which the user types his PASSWORD. (LOGIN). 

PAUSE. . . (tC TO QUIT, CR TO CONT) 

The /PAUSE switch has been specified, andan operator action is about to be requested. ■ IC 
aborts the command before the request is queued to the operator Carnage ^urn-^me teed 
allows the command to continue, and the request is queued to the operator. (DISMOUNT). 

?PC OUT OF BOUNDS AT USER adr 

An illegal transfer has been made by the user program to user location adr. 

? PLEASE KJOB OR DETACH 

Attempt was made to LOGIN a job when the user already has a job initialized at that terminal. 
(LOGIN). 

? PLEASE LOGIN AS [OPR] 

The operator is the only person that can initialize DAEMON by typing R DAEMON. 

? PLEASE TYPE tC FIRST 

A command which would start a job has been issued after a CSTART or CCONT. 

?PPN HAS EXPIRED 

The current date is greater than the expiration date of the project-programmer number . The 
user may not login until expiration date is changed by the system manager. (LOGIN). 
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? PROGRAM ERROR WHILE RESETTING MASTER DEVICE 

(F U UDGK) ann ° f ^^ tHe maSt6r deVlCe ™ CQnn0t "^ ^ Pr09mm °" the maSter dev?Ce ' 

? PROJECT 1 MAY NOT BE PTY 

Project 1 is never allowed to login over a pseudo-TTY. (LOGIN). 

? PROTECTION FAILURE DSK file.ext [pro| /P rog] 

(^ckup^storfT QCCeSS i0 the SpeCified dIsk areas f ° r either a read ora wrIte ' 

?(2) PROTECTION FAILURE - file.ext 

There was a protection failure or the directory on DECtape had no room for the file. (COMPIL). 
?PTR I NIT FAILURE 

The logical device PTR is not available or could not otherwise be initialized. (COPY program). 

QUOTA. SYS LOOKUP FAILURE 

The LOOKUP to read QUOTA.SYS failed. (MOUNT). 

QUOTA. SYS NOT ON STRUCTURE 

u^zVLZ%tuuT ucture - The user may sHn me «—" ^ ~ 

QUOTA.SYS READ ERROR 

An I/O error occurred while reading QUOTA. SYS. (MOUNT). 

QUOTA.SYS WRONG FORMAT VERSION 

Wrong^ersion of QUOTA.SYS is on the file structure being mounted. Consult the operator. 
%READ ERROR DSKn file [pre], prog] 

The BACKUP or RESTORE program cannot input the designated file. (BACKUP, RESTORE). 
?f?le structure name RENAME FAILURE n 

LOG R OUT) ME ^ ^^ ^ pr ° tecHon ° f the f?le failed ' n is th * disk error code. (KJOB, 

?(4) RENAME FILENAME ALREADY EXISTS - file.ext 

The new filename on a RENAME command already exists. (COMPIL). 
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REQUEST STORED 

n COMMANDS IN QUEUE 

The request typed by the user has been placed In a queue to****^^*"*^ 9 ' " U 
the number of requests in the queue for all users. (FILE, MOUNT, DISMOUNT). 

7REQUIRES DEVICE NAME 

The device name or file structure name is required with the MOUNT and DISMOUNT commands. 

$RESTOR COMPLETED AT time 

The RESTORE program has successfully completed. (RESTORE). 

7RIGHT BRACKET REQUIRED IN DIRECTORY 

The project-programmer number must be enclosed in square brackets. (QUEUE). 

%SEARCH LIST DOES NOT ALLOW CREATES 

There are no file structures available to the user on which he can write. Run MOUNT or 
SETSRC to modify the search list as necessary. (LOGIN). 

%SEARCH LIST ERROR [proj,prog] 

The BACKUP or RESTORE program is unable to obtain the search list for the named P^ect- 
programmer number. The program advances to the next project-programmer number. (BACKUP, 
RESTORE). 

%SEARCH LIST IS EMPTY 

There are no file structures in the DSK: search list that are available to the user. He can run 
the SETSRC program to modify his search list. (LOGIN). 

7SINGLE-ACCESS BY JOB n v 

The file structure is already single access by the indicated user. (MOUNT). 

file.ext SOFTWARE CHECKSUM OR REDUNDANCY ERROR 

The file has no error as flagged in the UFD of the file structure. (LOGIN). 

7SOME OTHER TIME 

The user is not scheduled to LOGIN at this time. He should try again when he is allowed to 
login. (LOGIN). 

7SORRY, CANT OPEN DSK, PLEASE CALL THE OPERATOR 
This message is returned from the GRIPE program. 

7SORRY, CANT WRITE IN COMPLAINT AREA, PLEASE CALL THE OPERATOR 
This message is returned from the GRIPE program. 
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9SORRY, COMPLAINT BASKET IS FULL, PLEASE CALL THE OPERATOR 
This message is returned from the GRIPE program. 

7SORRY, NO UFD FOR COMPLAINT BASKET, PLEASE CALL THE OPERATOR. 
This message is returned from the GRIPE program. 

(backup"! 
RESTORE] V *™ON n AT time YEAR nn DAY dd 

The BACKUP or RESTORE program is beginning its processing. (BACKUP, RESTORE). 
?STATION NOT IN CONTACT 

The requested station is not in contact with the central station. (LOCATE). 
?STATION NUMBER INVALID 

The requested station number is not recognized by the system. (LOCATE). 
STRUCTURE ALREADY MOUNTED 

(MOUNtT' fHe StmCtUre a ' ready ""^ Qnd d06S ^ ^ f ° be P^ sica,l >' moun ^. 

9STRUCTURE NOT IN STRLST.SYS 

The file structure name does not exist in the system administrator's file SYS-STRLST SYS «nH 
define the file structure by adding it to STRLST.SYS with the REACT program. (MOUNT) 

9STRUUO FAILURE 

The STRUUO UUO gave an error return. Notify the operator. (KJOB, LOGOUT). 
%SUPERSEDING EXISTING FILE 

taT^ST alco)." 9 ,hat a file already exis,s wi,h ,he specified — • ™« "'• >■ 

%SWAP READ ERROR UNIT cibc STATUS = n 

^°oN7,e°:ri e ;:.tcoREr 9 ,he swappins space - The da,a ;s ^ n "*> *• 

?SWITCH ERROR 

An illegal switch specification was given. (COPY program). 

?switch SWITCH ILLEGAL 

The switch specified cannot be used with the given queue name. (QUEUE, BACKUP, RESTORE). 
9SWITCH VALUE TOO LARGE x 

The value given to the switch exceeds the maximum value. (QUEUE). 
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?SYNTAX ERROR 

There is a syntax error in the command string. Check for incorrect parentheses or two operators 
in a row. 

9SYSSTR FAILURE 

The SYSSTR UUO gave an error return. Notify the operator. (KJOB, LOGOUT). 

9SYSTEM ERROR - xxxxxx 

System errors designate operator or system errors and are not a direct fault of the user. They 
are typed for possible diagnostic used. 

9SYSTEM NOT AVAILABLE 

The operator has used the SET SCHED command to prevent LOGINs from timesharing terminals. 
The message of the day is still typed. (LOGIN). 

9TABLE OVERFLOW - CORE UU.O FAILED TRYING TO EXPAND TO xxx 

The GLOB program requested additional core from the monitor, but none was available. 
(GLOB). 

?THIS MONITOR WAS BjJlLT FOR A xxx AND WILL NOT RUN PROPERLY ON A yyy 

The monitor is not running on the machine for which it was built, xxx and yyy are PDP-6, 
KA10, or KI10. 

?TIME LIMIT EXCEEDED 

The time limit allocated for the job has been reached. The job is stopped and the terminal is 
returned to monitor mode. 

TIMESHARING WILL CEASE IN m HOURS n MINUTES 

The KSYS command (OPSER) or SET KSYS UUO has been issued in order to stop timesharing on 
the system at the indicated time. 

?TOO FEW ARGUMENTS 

A command has been typed, but necessary arguments are missing. 

?TOO MANY FILENAMES OR PROGRAM NAMES 

More than 40 program names or filenames were specified in the command string. The user 
should separate the job into several segments. (FUDGE2). 

?TOO MANY FILE STRUCTURES 

The number of file structures exceeds the capacity of the monitor data base. The current limit 
is 14 . (ONCE ONLY). 



4-29 



COMMANDS - 776 - 

?TOO MANY NAMES or ?TOO MANY SWITCHES 

Command string complexity exceeds table space in the COMPIL program. (COMPIL). 

9TRANSMISSION ERROR 

During a SAVE, GET, or RUN command, the system received parity errors from the device, or 
was unable to read the user's file in some other way. This can be as simple as trying to write 
on a write- locked tape. 

7TRAN5MISSION ERROR ON INPUT DEVICE dev 

A transmission error has occurred while reading data from the specified device. (FUDGE2). 

?TRIED TO OVERWRITE DATA WORD 

After writing the core image file, DAEMON backs up to overwrite a word not known pre- 
viously (e.g., the length of the category). In overwriting the word, DAEMON encountered 
a deviation from the standard pattern used in originally writing the word. (DAEMON). 

?TRY LARGER ARG 

The specified argument is too small for the program. This message is followed by the standard 
output. (CORE). 

?TTYn ALREADY ATTACHED 

Job number is erroneous and is attached to another console, or another user is attached to the 
job. 

?TTY IN USE 

The terminal requested is already controlling a job or is otherwise in use. (REATTA). 

TYPE CORE BANK OR OFFSET FOR DTBOOT 

On a /T switch, COPr' asks for a core bank or offset for the bootstrap loader. The core bank 
i s 16K to 256K and the offset is 1000 to 777600 octal. (COPY program). 

TYPE H FOR HELP 

An unintelligible response or command has been typed. Either the filename or the CONFIRM: 
message is repeated* depending upon what was typed. (KJOB). 

?UFD ENTER FAILURE n 

Failure in trying to create UFD; n is the disk error code. Notify the operator. (LOGIN). 

%UFD ERROR DSKn [proj,prog] 

The BACKUP or RESTORE program cannot access the UFD (LOOKUP failure). It advances to 
the next UFD. (BACKUP, RESTORE). 
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?file structure name UFD INTERLOCK BUSY 

Could not get UFD interlock when trying to set up a UFD. The UFD is not currently set up. 
Notify the operator. (LOGIN). 

? UFD LOOKUP FAILURE n 

A failure occurred in setting up a UFD; n is the disk error code. Notify the operator. (LOGIN). 

?UFD OUTPUT FAILURE n 

The output failed when trying to create the UFD (4-series); n is the software channel status. 
(LOGIN). 

?file structure name UFD READ ERROR, STATUS = n 

A read error occurred while reading the user's UFD on the file structure. Status n tells which 
error occurred. Notify the operator. (KJOB, LOGOUT). 

?UFD RENAME FAILURE n 

A failure occurred in setting up a UFD; n is the disk error code. Notify the operator. (LOGIN). 

? UNDEFINED SWITCH switch 

The specified switch is either undefined or not unique. (MOUNT, DISMOUNT). , 

? UN EQUAL NUMBER OF MASTER AND TRANSACTION PROGRAMS 

On a replace request, the number of master programs (or files) does not equal the number of 
transaction programs (or files). (FUDGE2). 

UNIT abc ALREADY MOUNTED ON DRIVE DPAn 

The file structure is already mounted but is on different drives than the user specified. 
(MOUNT). 

? UN KNOWN COMMAND 

The monitor passed a command to COMPIL which COMPIL does not recognize. (COMPIL). 

7UNKNOWN DEFAULT FOR SWITCH switch 

The default condition is not known for the specified switch. (DUMP, QUEUE). 

7UNKNOWN OR INVALID COMMAND - TYPE GO TO CONTINUE 
This message is typed by the BACKUP and RESTORE programs. 

? UN KNOWN SWITCH switch 

. The switch named has been mistyped. (DUMP, QUEUE). 
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9UNKNOWN SWITCH VALUE n 

The argument specified with the switch has been mistyped. (DUMP, QUEUE). 

7UNRECOGNIZABLE SWITCH 

An ambiguous or undefined word followed a slash. (COMPIL). 

?UUO AT USER adr 

This message accompanies many error messages and indicates the location of the UUO that was 
the last instruction the user program executed before the error occurred. 

n VERIFICATION ERRORS 

On a word by word comparison requested via the /V switch, n discrepancies have been de- 
tected between the input DECtape and output DECtape. (COPY program). 

WAITING... 

A request has been queued to the operator and the command is waiting for the operator to com- 
plete the request. If the user does not want to wait for completion of the operator's action, 
he can type control-C without aborting the command. The operator action will still be com- 
pleted. Later a DISMOUNT/CHECK or MOUNT/CHECK can be given to check for comple- 
tion. (MOUNT, DISMOUNT). 

WAIT PLS 

The system's primary accounting file FACT. SYS was busy. It is retried for ten seconds before 
FACT.X01 is tried. This message can appear if many users are logging in simultaneously. 
(LOGIN, KJOB, LOGOUT). 

%WARNING - INPUT REQUEST USES ONLY TWO ENTRIES 
r 

Only two files can be specified in the input queue request, the control file and the loq file. 
(QUEUE). 

IWARNING NO INDEX ON OUTPUT FILE-CONTINUING 

The user has changed the structure of the index library file when deleting, appending, or in- 
serting, thereby invalidating the index. The index has been removed from the new file. Re- 
indexing is required. (FUDGE2). 

?dev WASNT ASSIGNED 

The device is not currently assigned to the user's job and cannot be deassigned or reassigned by 
the job. 

7WASNT DET 

The specified device is not detached. 
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("name 1 

^WILDCARD ILLEGAL IN INPUT QUEUE FILE< DIRECTORY > 

^EXTENSION) 

The wildcard construction cannot be used when specifying the Batch input queue. (QUEUE). 

TNAME ^ 

^WILDCARD ILLEGAL IN OUTPUT < DIRECTORY } 

\extensionj 

The wildcard construction cannot be used m the output queue specification. (QUEUE). 

7WRITE LOCK ERROR 

An attempt was made to write on a write-locked DECtape. (COPY program). 

7WRONG FORMAT FOR SYMBOL 

A symbol was given in the format program symbol and a symbol name did not follow the colon; 
in other words, the colon must be followed by a symbol. (DUMP). 

7WRONG FORMAT VERSION NUMBER IN SYSTEM FILES 

Wrong version of ACCT.SYS or AUXACC.SYS is on the system. Consult the operator so that he 
can run REACT to change the accounting files. (LOGIN). 

YOU ARE LOGGED IN AS n,iti 

When a user logs in with a unique programmer number (project , #), this message informs him of 
the project-programmer number that LOGIN assigned. (LOGIN). 

?YOU DONT HAVE PRIVILEGES TO WRITE I CC| _ J FILE 

The user attempted to write in a file to which he did not have access. (DAEMON). 

?l+lnKCORE 

VIR. CORE LEFT = 

The swapping space or the core allocated to timesharing is all in use (i .e. , there is no avail- 
able S colre). The user should wait a few minutes, and then attempt to login again. If 
this message still appears, it should be reported to the operator. 

m+n/p CORE 

VIR. CORE LEFT = v 

Key: m = number of blocks in low segment. 

n = number of blocks in high segment. 

p = maximum core per job. (Maximum physical user core unless limited by operator, or 

there are jobs locked in core (refer to DECsvstem-10 Monitor Calls)). 

v = number of K blocks unassigned in core and on the swapping device. 
Note that nK represents 1024-word blocks which is the unit of core allocation on a KA10- 
basld system, an'd nP respresents 512-word blocks which is the unit of allocate on a KI10- 
based system. 
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4.2 ERROR CODES 

The following error codes are returned in AC on RUN and GETSEG UUOs, in location E + 1 on 4-word 
argument blocks of LOOKUP, ENTER, and RENAME UUOs, and in the right half of location E + 3 on 
extended LOOKUP, ENTER, and RENAME UUOs. The codes are defined in the S.MAC monitor file. 

Table 4-1 
Error Codes 



Symbol 



ERFNF% 
ERIPP% 



ERPRT% 


2 


ERFBM% 


3 


ERAEF% 


4 


ERISU% 


5 


ERTRN% 


6 



ERNSF% 
ERNEC% 
ERDNA% 
ERNSD% 
ERILU% 

ERNRM% 

ERWLK% 
ERNET% 
ERPOA% 
ERBNF% 



G>de 



7 
10 

11 
12 
13 

14 

15 
16 
17 
20 



Explanation 



File not found, illegal filename (0,*), or filenames do 
not match (UPDATE). 

UFD does not exist on specified file structures. (Incor- 
rect project-programmer number.) 

Protection failure or directory full on DTA. 

File being modified (ENTER). 

Already existing filename (RENAME) or different filename 
(ENTER after LOOKUP). 

Illegal sequence of UUOs (RENAME with neither 
LOOKUP nor ENTER, LOOKUP after ENTER). 

a. Transmission, device, or data error 
(RUN, GETSEG only). 

b. Hardware-detected device or data error de- 
tected while reading the UFD RIB or UFD 
data block . 

c. Software-detected data inconsistency error 
detected while reading the UFD or file RIB. 

Not a saved file (RUN, GETSEG only). 

Not enough core (RUN, GETSEG only). 

Device not available (RUN, GETSEG only). 

No such device (RUN, GETSEG only). 

Illegal UUO (GETSEG only). No two-register relocation 
capability. 

No room on this file structure or quota exceeded (over- 
drawn quota not considered) . 

Write-lock error. Cannot write on file structure. ; 

Not enough table space in free core of monitor. 

Partial allocation only . 

Block not free on allocated position. 



(continued on next page) 
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Table 4-1 (Cont) 
Error Codes 



Symbol 


Code 


Explanation 


ERNSD% 


21 


Cannot supersede an existing directory (ENTER). 


ERDNE% 


22 


Cannot delete a non-empty directory (RENAME). 


ERSNF% 


23 


Sub-directory not found (some SFD in the specified path 
was not found). 


ERSLE% 


24 


Search list empty (LOOKUP or ENTER was performed on 
generic device DSK and the search list is empty). 


ERLVL% 


25 


Cannot create a SFD nested deeper than the maximum 
allowed level of nesting. 


ERNCE% 


26 


No file structure in the job's search list has both the no- 
create bit and the write-lock bit equal to zero and has the 
UFD or SFD specified by the default or explicit path 
(ENTER on generic device DSK only). 


ERSNS% 


27 


A GETSEG from a locked low segment is not for a high 
segment that is a dormant, active, or idle segment. 
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APPENDIX A 
STANDARD FILENAME EXTENSIONS 



Table A-l 
Filename Extensions 



Filename Extension 



AID 

ALG 

ALP 

ATO 

BIO 

Bll 

BAC 

BAK 

BAS 

BCM 

BIN 

BKP 

BLB 

BLI 

BUG 

CAL 

CBL 

CCL 

CCO 
CDP 
CKP 



Meani ng 



Source file in AID language 

Source file in ALGOL language 

Printer forms alignment 

OPSER automatic command file 

Source file in BLISS-10 

Source file in BLISS-11 

Output from the BASIC Compiler 

Backup file from TECO or LINED 

Source file in BASIC language 

Listing file created by FILCOM (binary compare) 

Binary file for PDP-8 (DC68A) 

Index fib created by the BACKUP program 

Blurb file 

Source file in BLISS language 

Saved to show a program error 

CAL data and program fi les 

Source file in COBOL language 

Alternate convention for command file (@ com- 
mand file construction for programs other than 
COMPIL) 

Listing of modifications to non resident software 
Spooled output for card punch 
Checkpoint core image file created by COBOL 
operating system 



Type of Fi le 



Source 

Source 

ASQI 

ASCII 

Source 

Source 

Object 

Source 

Source 

ASQI 

Object 

ASCII 

ASCII 

Source 

Object 

Object 

Source 

ASCII 
ASCII 
ASCII, Binary 

Binary 



(continued on next page) 
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Table A-l (Cont) 
Filename Extensions 



Filename Extension 



CHN 
CMD 

CMP 

COR 

CRF 

CTL 

DAE 

DAT 

DDT 

DIR 

DMP 

DOC 

DSE 

DSF 

ERR 

F4 

FAL 

FLO 

FRM 

FUD 

HGH 

HLP 

IDA 

IDX 

INI 

LAP 

LIB 

LOG 



Meaning 



CHAIN file 

Command file for indirect commands (@ construc- 
tion for COM PI L) 

Complaint file by GRIPE 

Correction file for SOUP 

CREF (cross-reference) input file 

MP batch control file 

Default output for DAEMON-taken core dumps 

Data (FORTRAN) file 

Input file to FILDDT 

Directory from FILE command or DIRECT program 

COBOL compiler dump file 

Listing of modifications to the most recent version 
of the software 

Directory sorted by extension 

Directory sorted by filename 

Error message f? le 

Source file in FORTRAN language 

Source file in FAIL language 

Einglish language flowchart 

Blank form for handwritten records 

FUDGE2 listing output 

Nonsharable high segment of a two-segment pro- 
gram (created by SAVE command) 

Help files containing switch explanations, etc. 

COBOL ISAM data file 

Index file of a COBOL ISAM file 

Initialization file 

Output from the LISP compiler 

COBOL source library 

MP batch log file 



Type of Fi le 



Object 

ASCII 
ASCII 
ASCII 

Asai 
Asai 

Binary 

ASCII, Binary 
ASCII 
ASCII 
ASQI 

Asai 

ASCII 
ASCII 

Asai 

Source 
Source 

Asai 

ASCII 
ASCII 

Object 
ASQI 

ASCII, Binary 
ASCII, SIXBIT 
ASQI, Binary 
ASCII 
ASQI 
ASCII 



(continued on next page) 
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Table A- 1 (Cont) 
Filename Extensions 



Filename Extension 



LOW 

LPT 

LSD 

LSP 

LSQ 

LST 

MAC 

MAN 

MAP 

MEM 

MIM 

MSB 

MUS 

OLD 

OPR 

OVR 

PAL 

Pll 

PL1 

PLT 

PTP 

Qxx 

QUD 

QUE 

QUF 

REL 

RIM 

RMT 

RNC 

RND 



Meani ng 



Low segment of a two-segment program (created 
by SAVE command) 

Spooled output for line printer 

Default output for DUMP program 

Source file in LISP language 

Queue listing created by QUEUE program 

Listing data created by assemblers and compilers 

Source file in MACRO language 

Manual (documentation) file 

Loader map fi le 

Memorandum file 

Snapshot of MIMIC simulator 

Music compiler binary output 

Music compiler input 

Backup source program 

Installation and assembly instructions 

COBOL overlay file 

Source file in PAL 10 (PDP-8 assembler) 

Source program in MACXII language 

Source file in PL! language 

Spooled output for plotter 

Spooled output for paper-tape punch 

BAK files (all xx) 

Queued data file 

Queue request fi le 

Master queue and request file 

Relocatable binary file 

RIM loader fi le 

Read-in mode (RIM) format file (PIP) 

RUNOFF input for producing a .CCO file 

RUNOFF input for producing a .DOC file 



Type of File 



Object 

Asai 

ASCII 

Source 

ASCII 

ASQI 

Source 

ASCII 

ASCII 

ASQI 

Bi nary 

Object 

Source 

Source 

ASCII 

Object 

Source 

Source 

Source 

ASCII 

ASCII, Binary 

ASQI 

ASCII, Binary 

Binary 

Binary 

Object 

Object 

Object 

ASCII 

ASCII 
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Table A-l (Cont) 
Filename Extensions 



Filename Extension 


i 

Meaning 


Type of Fi le 


RNO 


Programming specifications in RUNOFF input 


ASCII 


RNP 


RUNOFF input for producing a . OPR file 


ASCII 


RSP 


Script response time log file 


ASCII 


RST 


Index file created by the RESTORE program 


ASCII 


RTB 


Read-in mode (RIM 1 OB) format file (PIP) 


Object 


SAV 


Low segment from a one-segment program 
(created by SAVE command) 


Object 


SCM 


Listing file created by FILCOM (source compare) 


ASCII 


SCP 


SCRIPT control file 


ASCII 


SEQ 


Sequential COBOL data file, input to ISAM 






program 


ASCII, SIX BIT 


SFD 


Subfile directory (restricted usage) 


Bi nary 


SHR 


Sharable high segment file of a two-segment pro- 
gram (created by SAVE command) 


Object 


SNO 


Source file in SNOBOL language 


Source 


SNP 


Snapshot of disk by DSKLST 


ASCII 


SRC 


Source files 


ASCII 


SVE 


. SAVed file from a single user monitor 


Object 


SYS 


Special system files 


Binary 


TEC 


TECO macro 


ASQI 


TEM 


Temporary files 


ASCII, Binary 


TMP 


Temporary files 


ASCII, Binary 


TXT 


Text file 


ASCII 


UFD 


User file directory (restricted usage) 


Bi nary 


UPD 


Updates flagged in margin (FILCOM) 


ASCII 


WCH 


SCRIPT monitor (WATCH) file 


ASCII 


XPN 


Expanded save file (FILEX) 


Object 
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Table B-l 
ASCII Card Codes 



APPENDIX B 
CARD CODES 



ASCII 
Character 



NULL 

CTRL-A 

CTRL-B 

CTRL-C 

CTRL-D 

CTRL-E 

CTRL-F 

CTRL-G 

CTRL-H 

TAB 

LF 

VT 

FF 

CR 

CTRL-N 

CTRL-O 

CTRL-P 

CTRL-Q 

CTRL-R 

CTRL-S 

CTRL-T 

CTRL-U 

CTRL-V 

CTRL-W 

CTRL-X 

CTRL-Y 

CTRL-Z 

ESCAPE 

CTRL-V 

CTRL-] 

CTRL-t 

CTRL-- 

SPACE 



Octal 
Code 



00 

01 

02 

03 

04 

05 

06 

07 

10 

1 1 

12 

13 

14 

15 

16 

17 

20 

21 

22 

23 

24 

25 

26 

27 

30 

31 

32 

33 

34 

35 

36 

37 

40 



Card 
Punches 



12-0-9-8-1 

12-9-1 

12-9-2 

12-9-3 

9-7 

0-9-8-5 

0-9-8-6 

0-9-8--7 

11-9-6 

12-9-5 

0-9-5 

12-9-8-3 

12-9-8-4 

12-9-8-5 

12-9-8-6 

12-9-8-7 

12-11-9-8 

11-9-1 

11-9-2^ 

11-9-3' 

9-8-4 

9-8-5 

9-2 

0-9-6 

11-9-8 

11-9-8-1 

9-8-7 

0-9-7 

H_9„8-4 

11-9-8-5 

11-9-8-6 

11-9-8-7 



ASCII 
Character 



-1 



A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

O 

P 

Q 

R 

S 

T 

U 

V 

W 

X 

Y 

Z 

[ 

V 

] 

t A 



Octal 
Code 



100 

101 

102 

103 

104 

105 

106 

107 

110 

111 

112 

113 

114 

115 

116 

117 

120 

121 

122 

123 

124 

125 

126 

127 

130 

131 

132 

133 

134 

135 

136 

137 

140 



Card 
Punches 



NOTE: 



The ASCII character ESCAPE (octal 33) is also CTRL-C on a terminal. 



8-4 
12-1 
12-2 
12-3 

12-4 

12-5 

12-6 

12-7 

12-8 

12-9 

11-1 

11-2 

11-3 

11-4 

11-5 

11-6 

11-7 

11-8 

11-9 

0-2 

0-3 

0-4 

0-5 

0-6 

0-7 

0-8 

0-9 

12-8-2 

0-8-2 

11-8-2 

11-8-7 

0-8-5 

8-1 
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Table B-l (Cont) 
ASCII Card Codes 



ASCII 
Character 



/ 



1 

2 

3 

4 

5 

6 

7 

8 

9 



Octal 
Code 



Card 
Punches 



41 


12-8-7 


42 


8-7 


43 


8-3 


44 


11-8-3 


45 


0-8-4 


46 


12 


47 


8-5 


50 


12-8-5 


51 


1 1-8-5 


52 


11-8-4 


53 


12-8-6 


54 


0-8-3 


55 


11 


56 


12-8-3 


57 


0-1 


60 





61 


1 


62 


2 


63 


3 


64 


4 


65 


5 


66 


6 


67 


7 


70 


8 


71 


9 


72 


8-2 


73 


11-8-6 


74 


12-8-4 


75 


8-6 


76 


0-8-6 


77 


0-8-7 



ASCII 
Character 



m 
n 
o 
P 

q 

r 
s 
t 
u 

V 

w 

X 

y 

z 



DEL 



Octal 
Code 



141 

142 

143 

144 

145 

146 

147 

150 

151 

152 

153 

154 

155 

156 

157 

160 

161 

162 

163 

164 

165 

166 

167 

170 

171 

172 

173 

174 

175 

176 

177 



Card 
Punches 



12-0-1 

12-0-2 

12-0-3 

12-0-4 

12-0-5 

12-0-6 

12-0-7 

12-0-8 

12-0-9 

12-11-1 

12-11-2 

12-11-3 

12-11-4 

12-11-5 

12-11-6 

12-11-7 

12-11-8 

12-11-9 

11-0-2 

1 1-0-3 

11-0-4 

11-0-5 

11-0-6 

11-0-7 

11-0-8 

11-0-9 

12-0 

12-11 

11-0 

11-0-1 

12-9-7 



wh?c T rf i, It ASCI1 ^ITI } u^ ~ (OCta ' 175 Qnd 176) ° re treafed ^ the ™^ «« ALTmode" 
which is often considered to be the same as ESCAPE. 
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Table 


B-2 








DEC -029 Card Codes 




_ 1 




Octa 1 


Card 




Octal 


Card 


Character 


Code 


Punches 


Character 


Code 


Punches 


SPACE 


40 




@ 


100 


8-4 


| 


41 


11-8-2 


A 


101 


12-1 


H 


42 


8-7 


B 


102 


12-2 


# 


43 


8-3 


C 


103 


12-3 


$ 
% 


44 


11-8-3 


D 


104 


12-4 


45 


0-8-4 


E 


105 


12-5 


& 


46 


12 


F 


106 


12-6 




47 


8-5 


G 


107 


12-7 


( 

) 
* 


50 


12-8-5 


H 


110 


12-8 


51 


11-8-5 


I 


111 


12-9 


52 


11-8-4 


J 


112 


11-1 


+ 


53 


12-8-6 


K 


113 


11-2 




54 


0-8-3 


L 


114 


11-3 


/ 


55 


11 


M 


115 


11-4 




56 


12-8-3 


N 


116 


11-5 


/ 

o 


57 


0-1 


O 


117 


11-6 


60 





P 


120 


11-7 


1 


61 


1 


Q 


121 


11-8 


2 


62 


2 


R 


122 


11-9 


3 


63 


3 


S 


123 


0-2 


4 


64 


4 


T 


124 


0-3 


5 


65 


5 


U 


125 


0-4 


6 


66 


6 


V 


126 


0-5 


7 


67 


7 


W 


127 


0-6 


8 


70 1 8 


X 


130 


0-7 


9 


71 


9 


Y 


131 


0-8 




72 


8-2 


Z 


132 


0-9 


• 


73 


11-8-6 


c 


133 


12-8-2 


} 
< 


74 


12-8-4 


\ 


134 


11-8-7 




75 


8-6 


] 


135 


0-8-2 


> 


76 


0-8-6 


t A 


136 


12-8-7 


? 


77 


0-8-7 


1 *" 


137 


0-8-5 


NOTE: 0< 


:tal codes 0-37 and 140-177 are the same as in ASCII. 
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Table 


B-3 








DEC -026 Card Codes 








Octal 


Card 




Octal 


Card 


Character 


Code 


Punches 


Character 


Code 


Punches 


SPACE 


40 




@ 


100 


8-4 


j 


41 


12-8-7 


A 


101 


12-1 


9 


42 


0-8-5 


B 


102 


12-2 


43 


0-8--6 


C 


103 


12-3 


$ 
% 


44 
45 


1 f-8-3 
0-8-7 


D 
E 


104 
105 


12-4 
12-5 


& 


46 


11-8-7 


F 


106 


12-6 




47 


8-6 


G 


107 


12-7 


( 


50 


0-8-4 


H 


110 


12-8 


) 


51 


12-8-4 


I 


111 


12-9 




52 


11-8-4 


J 


112 


71—1 




53 


12 


K 


113 


11-2 


/ 


54 


0-8-3 


L 


114 


11-3 


m,, 


55 


11 


M 


115 


11-4 


/ 


56 


12-8-3 


N 


116 


11-5 


/ 


57 


0-1 


O 


117 


11-6 





60 





P 


120 


11-7 


1 


61 


1 


Q 


121 


11-8 


2. 


62 


2 


R 


122 


11-9 


3 


63 


3 


S 


123 


0-2 


4 


64 


4 


T 


124 


0-3 


5 


65 


5 


U 


125 


0-4 


6 


66 


6 


V 


126 


0-5 


7 


67 


7 


w 


127 


0-6 


8 


70 


8 


X 


130 


0-7 


9 


71 


9 


Y 


131 


0-8 


! 


72 


11-8--2/11-0 


z 


132 


0-9 


^ 


73 


0-8-2 


[ 


133 


11-8-5 


< 


74 


12-8-6 


\ 


134 


8-7 


= 


75 


8-3 


] A 


135 


12-8-5 


> 


76 


11-8-6 


t 


136 


8-5 


? 


77 


12-8-2/12-0 


*- 


137 


8-2 


NOTE: Oct 


al codes 0-37 anc 


i 140-177 are the same as in ASCII. 




... 



B-4 



-791 - 



COMMANDS 



APPENDIX C 
TEMPORARY FILES 



The temporary files in Table C-l are used by various programs in the DECsystem-10 computing system. 
These files are in the following form: * 

nnn xxx.TMP 
where nnn is the user's job number in decimal, with leading zeroes to make three digits, and xxx 
specifies the use of the file. 



Name 



nnn ALG.TMP 



nnn AS1.TMP 
nnn AS2.TMP 
nnn AS3.TMP 

nnn BLI .TMP 

nnn COB. TMP 



nnn CPY.TMP 
nnn CRE.TMP 



nnn DAE. TMP 
nnn DMP.TMP 



Table C-l 
Temporary Files 



Meaning 



Read by ALGOL and contains one line for each program to be com- 
piled. It may also contain the command NAME! which causes 
ALGOL to transfer control to the named program. 

Written, read, and deleted by COBOL and contains input to the 
COBOL assembler. 

Read by BLISS and contains one line for each program to be compiled. 

Read by COBOL and contains one line for each program to be com- 
piled. It may also contain the command NAME! which causes 
COBOL to transfer control to the named program. 
Written, read, and deleted by COBOL and contains copies of source 
files with library routines inserted. 

Read by CREF and contains commands for each file which has pro- 

duced a CREF listing on the disk. COMPIL also reads this file each 

time a new CREF listing is generated to prevent multiple requests 

for the same file and to prevent discarding other requests that may 

not yet have been listed. 

Written by DAEMON to be read by DUMP. 

Read by DUMP as an input command file. 
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Table C-l (Cont) 
Temporary Files 



Name 



nnn EDS.TMP 
nnn EDT.TMP 



nnn ERA.TMP 
nnn FOR.TMP 

nnn GEN.TMP 

nnn KJO.TMP 
nnn LGO.TMP 
nnn LIN.TMP 

nnn LIT.TMP 

nnn LOA.TMP 
nnn MAC.TMP 

nnn Pll.TMP 

nnn PLS.TMP 
nnn PIP.TMP 

nnn QUE.TMP 
nnn RNO.TMP 

nnn S01.TMP 

nnn SVC.TMP 

nnn SNO.TMP 



Meaning 



Used by COMPIL to store the arguments of the most recent EDIT 
CREATE, TECO, or MAKE command. 

Written by COMPIL and read by LINED or TECO. It contains a 
command for each EDIT, CREATE, TECO, or MAKE command. 
For the MAKE or CREATE commands, it contains the command 

Sfile.ext [p /P ] (D 
For TECO or EDIT commands, it contains the command 

S file.ext [p,p] ) 

Written, read, and deleted by COBOL and is the error file,, 

Read by FORTRAN and contains one line for each program to be 
compiled. It may also contain the command NAME! which causes " 
FORTRAN to transfer control to the named program. 

Written, read, and deleted by COBOL and contains the output of 
syntax processing. 

Read by KJOB as an input command file. 

Read by LOGOUT as an input command file. 

Created by LINED and contains output file until the rename 
process. 

Written, read, and deleted by COBOL and contains copy of the 
literal pool. 

Read by LOADER and contains commands necessary for loading. 

Read by MACRO and contains one line for each program to be 
assembled. It may also contain the command NAME! which causes 
MACRO to transfer control to the named program. 

Read by MACX11 (the PDP-11 assembler for the PDP-10) and con- 
tains one line for each program to be assembled. 

Read by PLEASE as an input command file. 

Read by PIP and contains commands to implement the COMPIL-class 
commands that run PIP. 

Read by QUEUE as an input command file. 

Read by RUNOFF and contains commands for each file which has 
produced a RUNOFF listing on the disk. 

Written, read, and deleted by COBOL and contains the inter- 
mediate sorted results of the data. 

Used by COMPIL to store the arguments of the most recent COMPILE 
LOAD, EXECUTE, or DEBUG command. 

Read by SNOBOL and contains one line for each program to be 
compiled. 



(continued on next page) 
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Name 



nnnTEC.TMP 
nnn TMP.TMP 
nnn XFO.TMP 
nnn XFR.TMP 



Table C-l (Cont) 
Temporary Files 



Meaning 



Created by TECO and contains output file until the rename process. 
Created by LINED during the rename process. 
Created by FILEX as a result of the Q switch on the output side. 
Created by FILEX as a result of the Q switch on the input side. 



C-3 



COMMANDS -794- 



-795 - 



COMMANDS 



APPENDIX D 
SAVE AND SSAVE COMMANDS 



Before writing SAVed or LOW files in response to SAVE and SSAVE commands (refer to the individual 
command descriptions in Chapter 2), the monitor compresses the user's core image by eliminating con- 
secutive blocks of zeroes. This technique is known as zero-compression and is used to save space on 
file media. Low segment files are zero-compressed on devices DTA, MTA, and DSK, but high seg- 
ment files are not because the high segment can be shared at the time of the command. 

SAVed files are ordinary binary files and can be copied using the /B switch in PIP. Files with the 
LOW or SAV extension may be read in dump mode, but must be reexpanded before being run. The 
monitor expands the file after input on a RUN, R, or GET command. The FILEX program may be used 
to expand the file for other purposes. 

The data format of a zero-compressed SAVed file consists of a series of IOWDs and data block pairs and 
is terminated by a JRST A where A is the program starting address as specified by the contents of . JBSA. 
The format is as follows: 



XWD 


-n1, 


adr 


1-1 






XWD 


-n2 


adr 


2-1 






XWD 


-nN 


adr 


N-1 




JRST 


A 







nl WORDS 



r.2 WORDS 



} 



nN WORDS 
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Each IOWD describes the length of the following data block and the original location of the data in 
core. The LH of the IOWD can be positive in which case the number of words is taken as the number 
of words greater than 128K . 

SAVed files are read into the user's core area starting at location .JBSAV and then are expanded to 
occupy the original relative locations. If the first word read is not an IOWD and is positive, an old- 
format, noncompressed saved fi le is assumed and no expansion is performed. 

A SAVE command issued to a magnetic tape writes 

a. a high segment (possibly null) 

b. an EOF 

c. a low segment (possibly null) 

d. an EOF. 



OR 



DED LHJ DEI HE2 DE] [ID [ID U« 



HIGH SEGMENT 



EOF 



RO Rt 



<w_ 



NULL HSGH SEGMENT 



LOW SEGMENT 



R2 EOF 



LOW SEGMENT 



EOF 



The monitor does not determine the file size of a low segment on a GET from magnetic tape; therefore, 
a user must always specify a core argument or have enough core assigned to his job for the file. 

To save file space, only the high segment up through the highest nonzero location (relative to high 
segment origin) loaded, as specified in the LH of . JBHRL, will be written by the SAVE command. If 
LH is zero (high segment created by CORE or REMAP UUO) or DDT is present, the entire high segment 
will be written. 

The LOADER indicates to the SAVE command how much data was loaded above the job data area in the 
low segment by setting the LH of . JBCOR to the highest location in the low segment that was not ex- 
plicitly loaded with data (either zero or nonzero). Most programs are written so that only the high 
segment contains nonzero data.. In this case, SAVE and SSAVE write only the high segments. This 
also saves file space and I/O time with the GET command. 

A number of locations in the job data area need to be initialized on a GET, although there is no other 
data in the low segment. The SAVE command copies these locations into the first 10g locations of the 
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high segment, provided it is not sharable. The locations are referred to as the vestigial job data area 
(refer to DECsystem-10 Monitor Calls, Chapter 1). Therefore, the LOADER will load high segment 
programs starting at location 400010. 

To prevent user confusion, SAVE and SSAVE delete a previous file with the extension .SHR or .HGH; 
therefore, SAVE deletes a file with the extension .SHR and SSAVE deletes a file with the extension 
.HGH. SAVE and SSAVE commands also delete files with the extension .LOW, if the high segment 
was the only segment written. 

The regular access rights of the saved file indicate whether a user can perform a GET, R, or RUN 
command. These commands assume that the user wants to execute (but not modify) the high segment, 
independent of the access rights of the file used to initialize the segment. The monitor ajways enables 
the hardware user-mode write protect to prevent the user program from storing into the segment in- 
advertently. 

To debug a reentrant system program, the user should make a private, nonsharable copy, rather than 
modify the shared vehion and possibly cause harm to other users. To make a private, nonsharable 
copy, the following commands are used: 

GET prog 

SAVE Writes a file in the user directory as nonsharable. The high 

segment in the user's addressing space remains sharable. 

GET Overlays the sharable program with the nonsharable one from 

the user's directory. Now the user can make patches while 
other users share the version in the library. 

If the user is debugging a sharable program in his UFD with the D command or the DDT program, it is 
recommended that the program be nonsharable instead of sharable. The reason for this is that the user 
may wish to modify the high segment during the debugging phase and later reinitialize the original 
unmodified high segment from the file with a GET command. However, since the high segment is 
sharable, the monitor will not do I/O into it, will not reinitialize it from the disk file, and the user 
will receive the modified high segment instead. 

NOTE 
DDT modifies the high segment when it inserts breakpoints. 

The following examples are the incorrect and correct methods of debugging a sharable program. After 
the debugging phase is completed, the SSAVE command should be used to save the program. 
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Example 1 : Incorrect Method 

^DFPim prog J 

EXECUTION 

tC 

_.SSAVF \ ;SAVE should be used in debugging 

_.GET J 

JOB SETUP ^ 

*E 4000 10 

400010/777777 777777 .D 0\ 

400010/ 

• GET^ 

JOB SETU P 

^E 4000 10^ 

400010/ ;not the original 777777 777777 

Example 2: Correct Method 



.DEBUG prog \ 
EXECUTION 




tC 




• SAV/E^ 




j-GET^ 
JOR SETUP 




• E 4000 10^ 




4000 1 0/777777 


7 7 7 7 7 7 


4000 10/ 




_.GFT^ 

JOB SETUP 




•E 4000 10 ^ 




4000 10/7 777 7 7 


777777 



;the original file 

Note that there are applications for a sharable data segment when the modified version of the sharable 
segment is wanted rather than the original segment as initialized from the file. The SSAVE command 
is then used. 

A SAVE of a one-segment program and a SSAVE of a two-segment program of the same name can coexist 
in the same directory, and the monitor keeps the two versions separate. This allows for a common li- 
brary, of reentrant and non-reentrant versions of the same system programs to service both the PDP-6 
and the DECsystem-10. A sharable program may be superseded into the directory by the SSAVE com- 
mand. The monitor clears the high segment in its table of sharable segments in use but does not remove 
the segment from the addressing space of users currently using it. Only the users doing a GET, R, or 
RUN command or a RUN or GETSEG UUO have the new sharable version. 

When the SAVE or SSAVE command is used to save a sharable program with only a high file, the moni- 
tor does not modify the vestigial job data area. This prohibits unauthorized users from modifying the 
first 10 locations of a shared segment by executing a SAVE or SSAVE command. This restriction does 
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not exist if a low file is also written, because the GET command reads the low file after the high file, 
so that the real job data area locations are set from the low file. To change the version number of a 
sharable two-segment program with only a high file, the following commands are used. 



GET prog 

SAVE 

GET 

D nnn mmm 137 

SSAVE 



The SAVE command makes the program non-sharable so that the vestigial |ob data area can be modified 
by the SSAVE. . 
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